API de WhatsApp
Envie e receba WhatsApp pela API
Conecte o seu número, envie com um POST e receba cada resposta, entrega e leitura por webhook assinado ou por consulta. Sem processo de aprovação de modelos de mensagem.
POST /v1/messages
{
"to": {
"number": "+5511988887777"
},
"content": {
"text": "Seu pedido saiu para entrega."
}
}202 Accepted
{
"message_id": "msg_01993c5a1b24d3e9f01a2b3c4d5e6f70",
"status": {
"state": "pending"
}
}Webhook: message.delivered
{
"type": "message.delivered",
"number_alias": "main",
"data": {
"id": "msg_01993c5a1b24d3e9f01a2b3c4d5e6f70"
}
}Do zero ao primeiro envio
O número precisa estar conectado antes do primeiro envio.
- 1
Crie a conta
Grátis e sem cartão de crédito.
- 2
Conecte o número
No dashboard, vincule o WhatsApp do celular do número que vai enviar as mensagens, por QR code ou código de pareamento.
- 3
Gere a chave de API
Crie uma chave com os escopos que a sua integração precisa.
- 4
Envie a primeira mensagem
POST /v1/messages com o destinatário e o conteúdo.
O que a API cobre
Os recursos do aplicativo, por HTTP.
- Enviar
- Texto, imagem, áudio, vídeo, documento, localização, cartão de contato, evento de calendário e botão com link.
- Receber
- Mensagens, entregas, leituras e mudanças do número chegam por webhook assinado nos planos pagos ou por consulta em todos os planos.
- Interagir
- Responder citando, reagir, editar, apagar, mostrar "digitando" e marcar como lida.
- Grupos
- Ler grupos e eventos de participantes em todos os planos. Enviar para grupos a partir do Empresarial.
- Mídia no seu armazenamento
- Arquivos recebidos e enviados ficam no seu próprio bucket (Cloudflare R2, Supabase Storage ou AWS S3).
- Contatos e números
- Consulte contatos e fotos de perfil e, a partir do Empresarial, opere números extras na mesma conta.
Alguns recursos dependem do plano. Veja o que cada um inclui em Planos e preços.
Conectado como o WhatsApp Web
O seu número entra como um dispositivo conectado. Nada muda para quem usa o celular.
- Sem processo de aprovação
- Comece a enviar hoje, sem cadastro na Meta e sem aprovar modelos de mensagem. Veja a comparação com a API oficial do WhatsApp Business nas perguntas frequentes.
- O celular continua seu
- O WhatsApp segue funcionando no celular, e o Turbo Notify aparece em Dispositivos conectados com o nome da sua organização.
- Um ritmo que protege o número
- Cada envio respeita um intervalo mínimo que acompanha o plano, e números recém-conectados passam por um aquecimento. Isso reduz o risco de restrição. Quem decide é o WhatsApp, então envie para quem espera a sua mensagem.