Notificaciones que Se Leen
Deje de perder notificaciones importantes en carpetas de spam. Envíe recordatorios, alertas de pago y actualizaciones de cuenta como plantillas aprobadas de WhatsApp desde su backend, y siga los estados de enviado, entregado, leído y fallido con webhooks firmados.
✦ Prueba gratis de 14 días · Tu propio número de WhatsApp Business · Meta factura los mensajes directamente
Tipos de Notificaciones
-
Recordatorios de Citas
Recordatorios automáticos de citas con botones de respuesta rápida para confirmar o reprogramar. Cada toque llega a su webhook.
-
Alertas de Pago
Confirmaciones de pago, recordatorios de facturas, renovaciones de suscripción y alertas de retraso.
-
Notificaciones de Cuenta
Mensajes de bienvenida, restablecimiento de contraseñas, alertas de seguridad y actividad de la cuenta.
-
Actualizaciones de Servicio
Ventanas de mantenimiento, lanzamientos de características, cambios de políticas y estado del sistema.
Entregas que Puede Seguir
Cada envío devuelve un ID de mensaje, y su propio clientReference (el ID de una factura o cita) vuelve en cada webhook de enviado, entregado, leído y fallido. Un mensaje fallido incluye un código y un motivo en lenguaje claro, para que su sistema decida qué hacer, como reintentar más tarde o escribir un email al cliente. No hay respaldo automático a SMS.
- Su clientReference en cada acuse de entrega
- Confirmación de entrega en tiempo real y registros de webhook
- Encabezado Idempotency-Key para reintentos seguros
Ciclo de Vida de Entrega de Notificaciones
1. Evento Disparado
Un evento en su sistema (pago, recordatorio) llama a POST /api/v1/messages con una plantilla de utilidad aprobada y su clientReference.
2. Enviado a WhatsApp
Meta acepta el mensaje y se dispara el webhook message.sent; message.delivered y message.read llegan a medida que ocurren.
3. Usted Actúa Según el Resultado
Si llega un message.failed, incluye el código del fallo, el motivo y su clientReference, para que su sistema reintente, avise a su equipo o contacte al cliente por otra vía.
Alertas WhatsApp vs. SMS vs. Notificaciones por Email
Compare formato, interactividad y seguimiento de entrega.
| Factor de Alcance | Alertas WhatsApp | Alertas SMS | Notificaciones de Email |
|---|---|---|---|
| Botones Interactivos | ✓ (CTAs clicables / Respuestas rápidas) | ✗ (Solo enlaces de URL simples) | ✓ (Enlaces de diseño HTML) |
| Acuses de Entrega y Lectura | ✓ (Webhooks de enviado, entregado, leído y fallido) | Solo informes de entrega | Seguimiento de aperturas (a menudo bloqueado) |
| Recibos PDF Completos | ✓ (Enviado como archivo adjunto directo) | ✗ (Sin soporte a archivos) | ✓ (Adjuntos estándar) |
Envía una alerta transaccional por 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'];Notificaciones — FAQ
¿Puedo enviar notificaciones a través de WhatsApp y SMS?
Sí, como dos productos separados de StartMessaging, cada uno con su propio registro y claves de API. No hay respaldo automático entre ellos. Si quiere usar SMS como alternativa, escuche el webhook message.failed de WhatsApp y envíe el SMS desde su propio código.
¿Existen restricciones locales para enviar notificaciones transaccionales?
En WhatsApp, las notificaciones deben usar plantillas de utilidad aprobadas vinculadas a una transacción o cuenta concreta, y aun así necesita el consentimiento del cliente para escribirle por WhatsApp. El SMS en India requiere además el registro DLT.
¿Cuánto cobra Meta por una notificación de WhatsApp?
Meta cobra cada plantilla de utilidad entregada según su tarifa de utilidad, directamente a su propia Cuenta de WhatsApp Business. Desde el 1 de octubre de 2026 esto incluye las plantillas de utilidad enviadas mientras la ventana de 24 horas del cliente está abierta, que antes eran gratis. StartMessaging no añade nada por mensaje, y el campo pricing de cada mensaje muestra la categoría con la que Meta lo cobró.
¿Cómo sé si una notificación no se entregó?
Suscríbase a los webhooks message.delivered, message.read y message.failed. Cada uno incluye el ID del mensaje y su clientReference, y message.failed añade un código y el motivo del fallo. También puede consultar GET /api/v1/messages/{id}. Las entregas van firmadas con HMAC-SHA256 y se reintentan durante unas 20 horas si su endpoint no responde.
¿Puedo adjuntar recibos PDF a las notificaciones transaccionales?
Sí. Use una plantilla con encabezado de documento y pase la URL pública del PDF en headerMediaUrl. Meta descarga el archivo y el cliente lo recibe como documento descargable en el chat.
Páginas Relacionadas
Actualice Sus Notificaciones
Comience con una prueba gratuita de WhatsApp de 14 días con todas las funciones del plan Business.