Claude Code, Cursor, Lovable e Bolt

A IA que escreve o seu código aprende a API sozinha se você apontar a documentação certa. Cole o pedido e ajuste a primeira linha.

O que a IA precisa ler

• https://dev.onesendz.com/llms.txt: regras, limites, webhooks e todas as ferramentas, em texto.
• https://dev.onesendz.com/openapi.json: a especificação completa (OpenAPI 3.1).

Pedido pronto

Crie uma chave de teste (oszt_), guarde como ONESENDZ_API_KEY e cole no seu assistente:

Quero [descreva o que o seu sistema deve fazer com o WhatsApp].
Use a API da OneSendz. Antes de escrever código, leia as regras em https://dev.onesendz.com/llms.txt
e a especificação em https://dev.onesendz.com/openapi.json.
A chave está na variável de ambiente ONESENDZ_API_KEY (é de teste: os envios são simulados).
Chame a API só pelo servidor (back-end ou função), nunca expondo a chave no navegador.
Em todo envio, use uma chave_idempotencia única por mensagem.
Para saber se a mensagem chegou ou falhou, cadastre um webhook com criar_webhook e confira a assinatura.

Em cada ferramenta

Claude Code e Cursor

Além do pedido acima, você pode ligar o MCP: o assistente passa a consultar a sua conta enquanto programa (ver templates, contatos, testar um envio no modo teste).

Lovable

Guarde a chave em Secrets do projeto e peça que a chamada fique numa função de servidor (Edge Function), nunca no código da página. Para receber webhooks, peça uma Edge Function pública que confira a assinatura.

Bolt e Replit

Guarde a chave nas variáveis de ambiente do projeto e peça uma rota de servidor para chamar a API e outra para receber os webhooks.

Exemplos de pedido

• "Quando um pedido for pago no meu sistema, mande o template pedido_confirmado para o cliente e guarde o mensagem_id."
• "Quando chegar mensagem.recebida, crie um ticket no meu painel com o texto e o telefone."
• "Lembre o cliente da consulta 24 horas antes com o template lembrete_consulta, e marque como não entregue se chegar mensagem.falhou."

Passo a passo completo: WhatsApp no Lovable e WhatsApp no Claude Code.