O seu time já responde aos clientes no ChatWoot. Isto alcança o mesmo ChatWoot pelo seu próprio código — as caixas de entrada, o que está aberto, o que foi dito e a resposta que você envia — sem uma segunda caixa de entrada e sem mover nada.
Conecte uma vez
Na página de salas, com a sessão iniciada: o endereço do painel do seu ChatWoot e um token de acesso de administrador. Conectar adiciona um webhook para que as respostas do time voltem; desfazer a conexão o remove. A API nunca aceita nenhum dos dois: POST /chatwoot/v1/connections/link responde 403 com a página onde eles entram.
O que está aberto
curl "https://makehybrid.com/chatwoot/v1/connections" \ -H "X-API-KEY: $MAKEHYBRID_KEY" curl "https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations?status=open" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Cada conversa traz o contato com quem ela é, o agente a quem está atribuída, a caixa de entrada e quando se mexeu pela última vez. As mensagens vêm da mais antiga para a mais recente, e cada uma diz em que sentido foi: incoming é a do cliente, outgoing a do time.
Responder, anotar, resolver
curl -X POST https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"content":"It went out this morning — here is the tracking link."}'
curl -X PATCH https://makehybrid.com/chatwoot/v1/connections/$CONNECTION_ID/conversations/$CONVERSATION_ID \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"status":"resolved"}'
Envie private como true e será uma nota que o cliente nunca vê. Qualquer outra coisa é escrita como o usuário conectado e o cliente a vê, então um agente que escreve em seu nome escreve diante do seu cliente.
Seja avisado em vez de perguntar
Cadastre um endpoint de webhook e cada mensagem de qualquer conversa desse ChatWoot é enviada a ele: a do cliente como chatwoot.message_received, a do time como chatwoot.message_sent. Os mesmos endpoints, a mesma assinatura da LinkedIn API.
curl -X POST https://makehybrid.com/chatwoot/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"url":"https://acme.com/hooks/chatwoot","events":["chatwoot.message_received"]}'
Perguntas frequentes
Os meus clientes vão ver alguma coisa nossa?
Não. É o seu ChatWoot no seu endereço, e tudo é escrito como o usuário cujo token ele é. Nada é rebatizado e nada nosso é instalado nele.
O que acontece quando o ChatWoot está fora do ar?
502 errors/chatwoot_unavailable, e nada é enfileirado nem tentado de novo pelas suas costas. Um token rejeitado é 409 errors/chatwoot_disconnected, o que significa que um membro precisa conectá-lo de novo.
Um agente de IA pode responder aos clientes por lá?
Pode, por https://makehybrid.com/chatwoot/mcp/<sua chave de API> ou em uma sala. Dê a ele instruções que digam quando responder e quando deixar uma nota privada: o cliente vê tudo o que não é privado.