Iniciar uma conversa com um contato é um POST em /inbox/v1/conversations, na MakeHybrid Inbox API: uma única caixa de entrada para WhatsApp, Instagram, Facebook, TikTok, Telegram, LINE, e-mail, SMS e o chat do seu site. Toda requisição leva a sua própria chave em um cabeçalho X-API-KEY — a mesma chave da API do LinkedIn — e chega só à conta de caixa de entrada da sua própria organização.
Uma caixa de entrada reúne todos os canais que você adiciona a ela, então a resposta volta pelo canal em que o cliente escreveu — WhatsApp, Instagram, e-mail ou qualquer outro — com a mesma chamada.
A requisição
curl -X POST "https://makehybrid.com/inbox/v1/conversations" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
O que volta quando não funciona
- 401 — a chave está faltando, está errada ou foi revogada.
- 402 — o plano não está pago. A MakeHybrid API responde isso quando o teste acaba.
- 404 — ou a coisa não está lá, ou não é da sua organização. As duas respostas são a mesma de propósito, para que ids não possam ser sondados.
- 429 — requisições demais, ou a plataforma pedindo que a gente diminua o ritmo. Espere um instante antes de tentar de novo.
- 502 ou 503 — a plataforma não respondeu agora há pouco. Tente de novo daqui a pouco.
Todo erro é JSON no mesmo formato: {"type":"errors/<code>","status":<n>,"detail":"..."} — então um único tratador cobre todos, e o detail foi escrito para ser mostrado a uma pessoa.
Pedir a um assistente
Esta operação também é uma ferramenta MCP. Cole https://makehybrid.com/inbox/mcp/<your API key> no Claude, no ChatGPT ou em qualquer assistente que fale MCP e peça o que quiser em português — o assistente escolhe a chamada, preenche os ids e lê a resposta para você. O agente tudo em um que está em https://makehybrid.com/mcp/<your API key> também a tem, ao lado da API do LinkedIn e de todos os outros canais.
Em uma sala de projeto
Em uma sala de projeto, marque o agente desta API em Pode usar para um agente de IA seu, e ele chama “Iniciar uma conversa com um contato” como ferramenta sempre que a conversa precisar. Todo mundo na sala vê o que ele pediu e o que voltou. Peça em palavras simples; aqui o agente se chama @scout:
- @scout liste as conversas abertas de hoje de todos os canais e redija uma resposta para a mais antiga.
Perguntas frequentes
Um agente de IA pode chamar “Iniciar uma conversa com um contato” por mim?
Pode. Qualquer assistente que fale MCP pode, pelo endereço acima, e também um agente de IA seu em uma sala de projeto com o agente desta API marcado. Os agentes integrados de uma sala não podem: eles aconselham, e não têm a sua chave.
Funciona fora de uma sala, a partir do meu próprio código?
Funciona. A requisição acima é a mesma operação que as ferramentas de um agente de IA chamam, com a mesma resposta e os mesmos erros, e a sua chave alcança os mesmos canais, por qualquer caminho que você entre.
Funciona em uma sala com a minha própria marca?
Funciona. Em um endereço de marca branca, a API, a sua referência e o seu agente de IA levam o nome do seu produto e alcançam os mesmos canais, com as mesmas regras.
Uma pessoa pode aprovar antes de um agente de IA fazer isso?
Escreva isso nas instruções do agente de IA: ele diz o que está prestes a enviar e espera uma pessoa na sala dizer que pode ir. Uma sala mostra cada resposta a todos que estão nela, então as palavras são vistas antes de chegarem a qualquer pessoa de fora.
Em qual plano está
Faz parte do plano MakeHybrid API, com a mesma chave da API do LinkedIn: $9 por assento por mês, $7 a partir de dez assentos e $5 a partir de mil. Você precisa de tantos assentos quantos tiver do tipo mais numeroso — contas do LinkedIn, números de WhatsApp, contas do X ou contas de caixa de entrada — e os 30 dias de teste cobrem um.