Responda a todos os canais a partir de uma só caixa de entrada

A tarefa: um só lugar onde cai cada mensagem de cliente, de qualquer app de onde ele escreva, e uma só chamada que responde a ele ali. Cinco passos, cada um uma requisição.

1. Crie a conta da caixa de entrada

curl -X POST https://makehybrid.com/inbox/v1/account \
  -H "X-API-KEY: $MAKEHYBRID_KEY"

Uma vez por organização. Chamar de novo devolve a mesma conta, então é seguro rodar a cada deploy.

2. Adicione canais

curl -X POST https://makehybrid.com/inbox/v1/inboxes \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'

curl -X POST https://makehybrid.com/inbox/v1/inboxes \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'

O chat do site responde com o trecho de código para colar antes de </body>; ele carrega do seu próprio domínio. O Instagram e o TikTok são adicionados por um link de login, o Facebook Messenger por um link que o administrador de uma página abre, e o LINE, o SMS e o WhatsApp com as credenciais da própria plataforma — a referência descreve cada um.

3. Receba as mensagens novas

curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'

Guarde o segredo que ele devolve: toda entrega é assinada com ele no cabeçalho x-mh-signature, e uma repetição do mesmo evento é normal.

4. Responda onde escreveram

curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'

A resposta sai pelo canal da própria conversa. Acrescente "private": true e ela vira uma nota que só a sua equipe vê.

5. Resolva

curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
  -H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
  -d '{"status":"resolved"}'

Uma conversa resolvida se reabre sozinha quando o cliente escreve.

Perguntas frequentes