Notificações

Notificações que São Lidas

Pare de perder notificações importantes em pastas de spam. Envie lembretes, alertas de pagamento e atualizações de conta como templates aprovados do WhatsApp a partir do seu backend e acompanhe os status de enviado, entregue, lido e com falha por webhooks assinados.

✦ Teste grátis de 14 dias · Seu próprio número do WhatsApp Business · A Meta cobra as mensagens diretamente

Tipos de Notificações

  • Lembretes de Consultas

    Lembretes automáticos de consulta com botões de resposta rápida para confirmar ou reagendar. Cada toque chega ao seu webhook.

  • Alertas de Pagamento

    Confirmações de pagamento, lembretes de faturas, renovações de assinatura e alertas de atraso.

  • Notificações de Conta

    Mensagens de boas-vindas, redefinições de senha, alertas de segurança e atividades de conta.

  • Atualizações de Serviço

    Janelas de manutenção, lançamentos de recursos, alterações de políticas e status do sistema.

Entregas que Você Acompanha

Cada envio retorna um ID de mensagem, e o seu clientReference (o ID de uma fatura ou consulta) volta em todos os webhooks de enviado, entregue, lido e com falha. Uma mensagem com falha traz um código e um motivo em linguagem simples, para que seu sistema decida o próximo passo, como tentar mais tarde ou enviar um email ao cliente. Não há fallback automático para SMS.

  • Seu clientReference em todos os recibos de entrega
  • Confirmação de entrega em tempo real e logs de webhook
  • Cabeçalho Idempotency-Key para novas tentativas seguras
Pré-visualização do status de entrega das notificações
Ciclo de Entrega

Ciclo de Vida de Entrega da Notificação

01

1. Evento Disparado

Um evento no seu sistema (pagamento, lembrete) chama POST /api/v1/messages com um template de utilidade aprovado e o seu clientReference.

02

2. Enviado ao WhatsApp

A Meta aceita a mensagem e o webhook message.sent é disparado; message.delivered e message.read chegam conforme acontecem.

03

3. Você Age Conforme o Resultado

Se chegar um message.failed, ele traz o código da falha, o motivo e o seu clientReference, para que seu sistema tente de novo, avise sua equipe ou contate o cliente por outro meio.

Comparações de Alertas

Alertas WhatsApp vs. SMS vs. Notificações por Email

Compare formatação, interatividade e rastreamento de entrega.

Fator de Alcance Alertas WhatsApp Alertas SMS Notificações de Email
Botões Interativos ✓ (CTAs clicáveis / Respostas rápidas) ✗ (Apenas links de URL brutos) ✓ (Links de layout HTML)
Recibos de Entrega e Leitura ✓ (Webhooks de enviado, entregue, lido e com falha) Apenas relatórios de entrega Rastreamento de abertura (muitas vezes bloqueado)
Recibos em PDF Rico ✓ (Enviado como anexo de arquivo) ✗ (Sem suporte a arquivos) ✓ (Anexos padrão)
API de Mensagens

Envie um alerta transacional no WhatsApp

curl -X POST https://waba-api.startmessaging.com/api/v1/messages \
  -H "Authorization: Bearer sm_live_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: appt-5512-reminder" \
  -d '{
    "to": "+919812345678",
    "type": "template",
    "template": {
      "name": "appointment_reminder",
      "language": "en_US",
      "parameters": [
        {
          "text": "Asha"
        },
        {
          "text": "Dr. Mehta"
        },
        {
          "text": "12 Oct, 4:30 PM"
        }
      ]
    },
    "clientReference": "appt-5512"
  }'
const res = await fetch('https://waba-api.startmessaging.com/api/v1/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.SM_API_KEY,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'appt-5512-reminder',
  },
  body: JSON.stringify({
    "to": "+919812345678",
    "type": "template",
    "template": {
      "name": "appointment_reminder",
      "language": "en_US",
      "parameters": [
        {
          "text": "Asha"
        },
        {
          "text": "Dr. Mehta"
        },
        {
          "text": "12 Oct, 4:30 PM"
        }
      ]
    },
    "clientReference": "appt-5512"
  }),
});

const { data } = await res.json();
console.log(data.id, data.status);
import os, requests

res = requests.post(
    'https://waba-api.startmessaging.com/api/v1/messages',
    headers={
        'Authorization': f"Bearer {os.environ['SM_API_KEY']}",
        'Idempotency-Key': 'appt-5512-reminder',
    },
    json={
      "to": "+919812345678",
      "type": "template",
      "template": {
        "name": "appointment_reminder",
        "language": "en_US",
        "parameters": [
          {
            "text": "Asha"
          },
          {
            "text": "Dr. Mehta"
          },
          {
            "text": "12 Oct, 4:30 PM"
          }
        ]
      },
      "clientReference": "appt-5512"
    },
)

data = res.json()['data']
print(data['id'], data['status'])
<?php
$body = <<<'JSON'
{
  "to": "+919812345678",
  "type": "template",
  "template": {
    "name": "appointment_reminder",
    "language": "en_US",
    "parameters": [
      {
        "text": "Asha"
      },
      {
        "text": "Dr. Mehta"
      },
      {
        "text": "12 Oct, 4:30 PM"
      }
    ]
  },
  "clientReference": "appt-5512"
}
JSON;

$ch = curl_init('https://waba-api.startmessaging.com/api/v1/messages');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SM_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: appt-5512-reminder',
    ],
    CURLOPT_POSTFIELDS => $body,
]);
$data = json_decode(curl_exec($ch), true)['data'];
echo $data['id'] . ' ' . $data['status'];
FAQs

Notificações — FAQ

Posso enviar notificações via WhatsApp e SMS?

Sim, como dois produtos separados da StartMessaging, cada um com seu cadastro e suas chaves de API. Não há fallback automático entre eles. Se quiser o SMS como alternativa, escute o webhook message.failed do WhatsApp e envie o SMS pelo seu próprio código.

Existem restrições locais para o envio de notificações transacionais?

No WhatsApp, as notificações precisam usar templates de utilidade aprovados, ligados a uma transação ou conta específica, e você ainda precisa do opt-in do cliente para enviar mensagens pelo WhatsApp. O SMS na Índia exige também o registro DLT.

Quanto a Meta cobra por uma notificação no WhatsApp?

A Meta cobra todo template de utilidade entregue pela tarifa de utilidade, diretamente na sua própria Conta do WhatsApp Business. Desde 1º de outubro de 2026, isso inclui os templates de utilidade enviados enquanto a janela de 24 horas do cliente está aberta, que antes eram grátis. A StartMessaging não acrescenta nada por mensagem, e o campo pricing de cada mensagem mostra a categoria em que a Meta a cobrou.

Como sei se uma notificação não foi entregue?

Assine os webhooks message.delivered, message.read e message.failed. Cada um traz o ID da mensagem e o seu clientReference, e o message.failed inclui um código e o motivo da falha. Você também pode consultar GET /api/v1/messages/{id}. As entregas são assinadas com HMAC-SHA256 e reenviadas por cerca de 20 horas se o seu endpoint estiver fora do ar.

Posso anexar recibos PDF a notificações transacionais?

Sim. Use um template com cabeçalho de documento e informe a URL pública do PDF em headerMediaUrl. A Meta busca o arquivo e o cliente o recebe como documento para download no chat.

WhatsApp API

Atualize Suas Notificações

Comece com um teste grátis de 14 dias do WhatsApp com todos os recursos do plano Business.