Construir sobre o API Tech Pad.

Início rápido

De zero para uma mensagem WhatsApp entregue em quatro etapas. Tudo aqui também funciona dentro do aplicativo Desenvolvedores → Visão geral página, que acompanha o seu progresso.

Autenticação

A API é autenticada com chaves API por espaço de trabalho enviadas como um token ao portador. Chaves são criadas e revogadas de Desenvolvedores → Chaves de API.

• Teclas com as quais começar ttp_live_ e são explorados para um espaço de trabalho.
• Criar uma chave separada por integração — cada chave rastreia a sua própria last used Hora de marcar.
• O segredo completo é exibido apenas uma vez na criação; não pode ser recuperado mais tarde. Reverenciar e recriar em vez disso.
• Enviar a chave na Authorization cabeçalho: Authorization: Bearer ttp_live_…

Enviar mensagem

Envia uma mensagem de modelo WhatsApp aprovada para um destinatário opted-in de um número conectado em sua área de trabalho.

Organismo de pedido

Pedido de exemplo

curl -X POST 'https://v1.thetechpad.com/functions/v1/api-send' \
  -H 'Authorization: Bearer ttp_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "phoneNumberId": "1122334455",
  "to": "15551234567",
  "template": {
    "name": "order_update",
    "language": "en",
    "parameters": ["Ava", "#4031"]
  }
}'

// JavaScript
const response = await fetch('https://v1.thetechpad.com/functions/v1/api-send', {
  method: 'POST',
  headers: { Authorization: 'Bearer ttp_live_...', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    phoneNumberId: '1122334455',
    to: '15551234567',
    template: { name: 'order_update', language: 'en', parameters: ['Ava', '#4031'] }
  })
});

Webhooks

Os webhooks de saída empurram eventos do ciclo de vida da mensagem para o seu ponto final HTTPS em tempo quase real. Gerenciar os parâmetros a partir de Desenvolvedores → Webhooks — adicionar, editar, pausar, testar e eliminar.

Eventos

• Os pontos de vista devem ser HTTPS e acessível a partir da internet.
• Cada endpoint assina um subconjunto escolhido de eventos; cada evento dispara com uma carga útil JSON contendo o ID da mensagem e o status.
• Usar Ensaio num ponto final para enviar uma amostra de entrega e verificar o seu manipulador.
• Os terminais em pausa mantêm a sua configuração, mas param de receber eventos.

Limites de taxa

As mensagens são enviadas até a taxa de pacotes do seu plano. O rendimento real pode ser menor quando a Meta aplica limites de nível de mensagens, qualidade do telefone ou nível de conta. Mensagens permanecem em fila de espera com segurança em vez de ser descartado.

Cada solicitação conta para sua quota de chamada API e é registrada nos logs da API com seu código de status e duração.

Registos e monitorização

Desenvolvedores → Logs mantém duas visões:

• Registros de API — cada pedido de API: método, ponto de avaliação, estado HTTP, modelo utilizado e duração.
• Registos de hook Web — todas as tentativas de entrega de ganchos web e os seus resultados.

Use-os para depurar envios mal-sucedidos, confirme entrega webhook e integrações de auditoria terminam.

Erros

Requisitos bem sucedidos retornam a 2xx Situação. Falhas retornam um status não- 2xx com um corpo JSON descrevendo o problema:

{
  "error": "Template not approved",
  "hint": "Check the template status in Templates — only APPROVED templates can be sent."
}