Construir sobre el API de plataforma técnica.

Inicio rápido

De cero a un mensaje de WhatsApp entregado en cuatro pasos. Todo aquí también funciona dentro de la aplicación. Desarrolladores → Descripción general página, que sigue su progreso.

Autenticación

La API se autentica con claves API por espacio de trabajo enviadas como token de portador. Las claves se crean y revocan desde Desarrolladores → Claves API.

• Las claves comienzan con ttp_live_ y tienen como ámbito un espacio de trabajo.
• Cree una clave separada por integración: cada clave realiza un seguimiento de la suya last used marca de tiempo.
• El secreto completo se muestra sólo una vez en el momento de la creación; no se puede recuperar más tarde. En su lugar, revoque y vuelva a crear.
• Envía la clave en el Authorization encabezado: Authorization: Bearer ttp_live_…

enviar un mensaje

Envía un mensaje de plantilla de WhatsApp aprobado a un destinatario habilitado desde un número conectado en su espacio de trabajo.

Cuerpo de la solicitud

Solicitud de ejemplo

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

Los webhooks salientes envían eventos del ciclo de vida de los mensajes a su punto final HTTPS casi en tiempo real. Administrar puntos finales desde Desarrolladores → Webhooks — agregar, editar, pausar, probar y eliminar.

Eventos

• Los puntos finales deben ser HTTPS y accesible desde Internet.
• Cada punto final se suscribe a un subconjunto elegido de eventos; cada evento se activa con una carga útil JSON que contiene la identificación y el estado del mensaje.
• Usar prueba en un punto final para enviar una entrega de muestra y verificar su controlador.
• Los puntos finales en pausa mantienen su configuración pero dejan de recibir eventos.

Límites de tarifas

Los mensajes se envían hasta la tarifa del paquete de su plan. El rendimiento real puede ser menor cuando Meta aplica límites de nivel de mensajería, calidad del teléfono o nivel de cuenta. Quedan mensajes en cola de forma segura en lugar de ser descartado.

Cada solicitud cuenta para su cuota de llamadas API y se registra en los registros de API con su código de estado y duración.

Registros y monitoreo

Desarrolladores → Registros mantiene dos vistas:

• Registros de API — cada solicitud de API: método, punto final, estado HTTP, plantilla utilizada y duración.
• Registros de webhook - cada intento de entrega de webhook y su resultado.

Úselos para depurar envíos fallidos, confirmar la entrega de webhooks y auditar integraciones de principio a fin.

Errores

Las solicitudes exitosas devuelven un 2xx estado. Los errores devuelven un estado distinto de 2xx con un cuerpo JSON que describe el problema:

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