API do Chatwoot: conversas, contatos e caixas de entrada com IA
O Chatwoot é uma plataforma de atendimento omnichannel de código aberto, e sua API REST cobre conversas, mensagens, contatos e configurações da conta. É usada por empresas que hospedam o próprio Chatwoot ou usam a versão em nuvem e querem plugar bots e automações. O acesso é por token de usuário ou de agent bot.
Os grandes recursos da API, em português claro.
Listar, filtrar, atribuir e mudar o status de conversas.
Enviar mensagens e notas privadas em uma conversa, com anexos.
Criar, buscar e atualizar contatos e seus atributos.
Consultar e configurar canais como WhatsApp, e-mail e site.
Classificar conversas e distribuir entre times.
Receber eventos de mensagens e conversas e responder como bot.
Como se acessa a API do Chatwoot.
- Com credencial da sua empresaCada chamada leva um token de acesso no cabeçalho: o token de perfil de um usuário ou o token de um agent bot criado na conta.
- Documentação oficialwww.chatwoot.com/developers/api
- Na instalação própria, os limites dependem do seu servidor; na nuvem, siga as regras do plano.
- Conversas contêm dados pessoais: defina retenção e quem vê o histórico.
- Comece com o bot em uma caixa de entrada só e escale depois.
- api chatwoot
- chatwoot api documentação
- chatwoot agent bot
- webhook chatwoot
- integração chatwoot ia
- chatwoot api enviar mensagem
O que um agente do iTeam faz com a API do Chatwoot.
O agente responde como bot nas caixas de entrada, resolve dúvidas comuns e passa para humano com a conversa resumida.
Cada conversa recebe etiqueta de assunto e urgência, e vai para a equipe certa.
O agente busca o cliente no CRM ou ERP e grava atributos no contato, como plano e último pedido.
Toda semana o agente lê as conversas resolvidas e mostra os motivos de contato que mais cresceram.
Da credencial ao agente trabalhando, com aprovação.
Criar o agent bot no Chatwoot
No Chatwoot, crie um agent bot (ou um usuário de integração), copie o token e defina em quais caixas de entrada ele atua.
Definir permissões por agente
No iTeam, a credencial do Chatwoot vai para o cofre e cada agente ganha uma lista fechada de ações (responder conversas, aplicar etiquetas, transferir para humano). Ações que alteram dados exigem aprovação de uma pessoa.
Validar em pequeno e depois ampliar
Comece por um caso: mande uma mensagem de teste em uma caixa de entrada interna. Com o resultado conferido, o processo ganha mais volume, sempre com auditoria e aprovação onde houver risco.
Dúvidas sobre a API do Chatwoot.
A API do Chatwoot é gratuita?
O Chatwoot é open source e a API vem junto, tanto na instalação própria quanto nos planos de nuvem. O custo é o da hospedagem ou do plano contratado.
Preciso programar para usar a API do Chatwoot com o iTeam?
Não precisa. O iTeam lê a documentação da API do Chatwoot, monta as chamadas e o time de implantação ajusta o fluxo com você. O que fica com a empresa é aprovar e acompanhar.
O agente do iTeam substitui os atendentes do Chatwoot?
Não. Ele atende como bot, resolve o que é repetitivo e transfere para a equipe com contexto. Os atendentes continuam no Chatwoot, com menos fila.
O que um agente de IA faz dentro do Chatwoot usando a API?
A API REST do Chatwoot cobre conversas, mensagens, contatos, caixas de entrada e etiquetas, e o agente atua como um bot na fila de atendimento. Ele responde dúvidas simples, aplica etiquetas, preenche atributos do contato e transfere para uma pessoa quando o caso é complexo. No iTeam, o agente de atendimento passa o histórico para o atendente humano.
Qual token usar na API do Chatwoot: o de usuário ou o de agent bot?
Ambos funcionam, enviados no cabeçalho da requisição. O token de perfil age como aquele usuário, com as permissões dele; o token de agent bot dá uma identidade de bot, mais clara para a auditoria e com escopo mais restrito. Para um agente de IA, o agent bot costuma ser a escolha, porque separa as mensagens do bot das de pessoas.
Como testar o agente no Chatwoot sem afetar clientes?
O Chatwoot é de código aberto, então você pode subir uma instância própria de teste, por exemplo com Docker, e criar uma caixa de entrada de site para simular conversas. Também dá para usar uma conta separada na versão em nuvem. Comece com o bot em uma caixa só e só depois ligue nas caixas de atendimento reais.
Dá para usar o Chatwoot hospedado por conta própria com agentes de IA?
Dá, e é um dos atrativos: na instalação própria, os limites dependem do seu servidor e os dados ficam sob seu controle, o que ajuda em exigências de residência de dados. A manutenção, as atualizações e a segurança do servidor passam a ser suas. Na nuvem, valem as regras e os limites do plano contratado.
Como o Chatwoot avisa o agente de que chegou mensagem nova?
Por webhooks: você cadastra um endereço e o Chatwoot envia eventos, como mensagem criada ou conversa aberta. Com o agent bot, o evento já vem direcionado ao bot da caixa de entrada. O agente responde pela API de mensagens. Valide a origem do webhook e trate eventos repetidos para não responder duas vezes ao mesmo cliente.
Como o agente transfere a conversa para um atendente humano no Chatwoot?
Pela API, o bot muda o status da conversa de pendente para aberta, o que a coloca na fila dos atendentes, e pode atribuir a uma equipe e deixar uma nota privada com o resumo. O atendente entra já sabendo o contexto. Defina gatilhos claros, como pedido do cliente, reclamação ou falha de entendimento, para a passagem acontecer.
As conversas do Chatwoot com agente de IA têm cuidado de LGPD?
Sim: nome, e-mail, telefone e o texto das conversas são dados pessoais. Defina por quanto tempo guardar o histórico e quem pode ver conversas inteiras, e evite que o agente leve dados de um cliente para a resposta de outro. A governança do iTeam registra quais conversas o agente leu e a quem encaminhou.
Quando o Chatwoot com agente de IA não é a melhor escolha?
Quando a empresa já tem outra plataforma de atendimento muito integrada, ou quando não há equipe para manter uma instalação própria e a versão em nuvem não atende. Também não ajuda se o problema é falta de atendentes para casos complexos, e não volume de perguntas simples. Nesses casos, conecte o agente à ferramenta que o time já usa.
