WhatsApp no Claude Code: MCP e API oficial para integrar no seu sistema
Atualizado em 26 de outubro de 2026
Com o Claude Code você usa o WhatsApp oficial de dois jeitos que se completam: o MCP, para o Claude consultar e testar a conta enquanto programa, e a API, para o código que ele escreve rodar no seu sistema.
1. Ligue o MCP
Crie uma chave de teste (oszt_), guarde em ONESENDZ_API_KEY e rode no terminal:
claude mcp add --transport http onesendz https://dev.onesendz.com/mcp --header "Authorization: Bearer $ONESENDZ_API_KEY"Pronto: o Claude passa a ver os templates, contatos e conversas da conta de teste, e consegue simular envios para conferir se a integração está certa.
2. Peça a integração
Cole no Claude Code, ajustando a primeira linha:
Quero que o meu sistema [o que deve acontecer com o WhatsApp].
Use a API da OneSendz. Leia as regras em https://dev.onesendz.com/llms.txt
e a especificação em https://dev.onesendz.com/openapi.json.
A chave está em ONESENDZ_API_KEY (é de teste: os envios são simulados).
Chame a API só no back-end. Em todo envio, use uma chave_idempotencia única.
Cadastre um webhook com criar_webhook para mensagem.recebida e mensagem.falhou e confira a assinatura.
Use o MCP da onesendz para listar os templates e testar um envio antes de terminar.3. Teste e vá para produção
No modo teste, cada envio volta com "modo": "teste" e nada chega a ninguém. Quando estiver tudo certo, troque a chave pela de produção (osz_). O código não muda.
MCP ou API: quando usar cada um
| MCP | API | |
|---|---|---|
| Para quê | O Claude consultar e testar enquanto você programa | O seu sistema enviar e receber em produção |
| Envio | Em dois passos, com confirmação (preparar e confirmar) | Numa chamada só, com chave de idempotência |
| Webhooks | Não | Sim |
Perguntas frequentes
O Claude Code consegue mandar mensagens de WhatsApp?
Sim, pelo MCP da OneSendz. Com uma chave de teste, os envios são simulados; com uma chave de produção, o Claude prepara a mensagem e só envia depois da sua confirmação.
Qual a diferença entre o MCP e a API?
O MCP é para o assistente de IA consultar e testar a conta enquanto você trabalha. A API é para o seu sistema enviar e receber mensagens em produção, com webhooks.
Funciona no Cursor e em outros editores?
Sim. Qualquer cliente MCP com transporte HTTP e cabeçalho de autorização usa o mesmo endereço, https://dev.onesendz.com/mcp.
Preciso pagar para testar?
Não. O modo teste é grátis e não envia nada de verdade. A cobrança começa só com a conexão de um número em produção.