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.