Verificar o vínculo de um número do WhatsApp é um GET em /whatsapp/v1/connection, na MakeHybrid WhatsApp API: o número de WhatsApp da sua própria organização, vinculado do mesmo jeito que o WhatsApp Web. 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ó ao número que a sua organização vinculou.
O número é o de um telefone de verdade, vinculado do mesmo jeito que o WhatsApp Web: escreva como uma pessoa escreve, no ritmo de uma pessoa e para pessoas que esperam ouvir de você.
A requisição
curl -X GET "https://makehybrid.com/whatsapp/v1/connection" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
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/whatsapp/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 “Verificar o vínculo de um número do WhatsApp” 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 mostre as minhas conversas não lidas do WhatsApp e resuma o que cada cliente perguntou.
Perguntas frequentes
Um agente de IA pode chamar “Verificar o vínculo de um número do WhatsApp” 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.
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.