Skip to main content
1

Crie sua chave de API

No painel da Superlead, acesse Integrações e gere uma nova chave de API.
A chave completa (sl_live_...) é exibida uma única vez, no momento da criação. Copie e guarde em um cofre de segredos. Se perder, revogue e crie outra.
2

Envie sua primeira mensagem

O destinatário em to precisa ser um lead existente da sua empresa (telefone em formato E.164). Para conversas abertas nas últimas 24 horas, envie texto livre:
curl -X POST https://api.superlead.app/v1/messages \
  -H "Authorization: Bearer sl_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5511999999999",
    "type": "text",
    "text": { "body": "Olá! Tudo certo com seu agendamento?" }
  }'
Se o lead não falou com você nas últimas 24 horas, use um template aprovado:
curl -X POST https://api.superlead.app/v1/messages \
  -H "Authorization: Bearer sl_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+5511999999999",
    "type": "template",
    "template": { "name": "nome_do_template", "language": { "code": "pt_BR" } }
  }'
A resposta 201 confirma que a mensagem foi aceita:
{
  "id": "msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
  "wamid": "wamid.HBgMNTU...",
  "external_id": null,
  "to": "+5511999999999",
  "type": "text",
  "status": "accepted",
  "created_at": "2026-07-03T14:30:00.000Z"
}
3

Consulte o status de entrega

accepted significa que o WhatsApp aceitou a mensagem — não que ela foi entregue. Use o id retornado para acompanhar:
curl https://api.superlead.app/v1/messages/msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f \
  -H "Authorization: Bearer sl_live_SUA_CHAVE"

{
  "id": "msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
  "status": "delivered",
  "status_updated_at": "2026-07-03T14:30:04.000Z",
  "error": null
}
Pronto. Você criou uma chave, enviou uma mensagem e consultou o status real de entrega.

​
Próximos passos

Envio de mensagens

Tipos de mensagem, janela de 24 horas e falhas assíncronas.

Tratamento de erros

O envelope de erro e o catálogo completo de códigos.