Referencia (endpoints)Plantillas
Ver las métricas de una plantilla
Úsalo para medir una plantilla de un número oficial con lo que informa Meta: enviados, entregados, leídos y clics por botón, día por día y en total, hasta 90 días.
GET
Permiso requerido: Contactos y conversaciones → Ver
Devuelve lo que Meta informa de una plantilla de un número de la API oficial de WhatsApp, día por día (UTC) y en total: mensajes enviados, entregados y leídos, clics por botón y, cuando Meta lo informa, el costo.
- Rango:
fromyto(AAAA-MM-DD, UTC, ambos inclusive), los dos o ninguno. Sin ellos: los últimos 7 días, hoy incluido. El rango llega hasta 90 días contando hoy;tono puede ser una fecha futura. Un rango inválido responde 422 con el detalle por campo. - Días sin datos: aparecen con los conteos en cero y
costennull. - Lecturas y clics: Meta los registra sólo durante los 7 días posteriores al envío; después puede informarlos en cero.
- Clics: sólo en plantillas de categoría MARKETING o UTILITY.
- Costo:
nullcuando Meta no lo informa (por ejemplo, si la cuenta de WhatsApp Business usa la línea de crédito de un socio). - Activación: las métricas de plantillas tienen que estar activadas en el Administrador de WhatsApp de la cuenta. Funnelchat no las activa por ti: Meta no permite desactivarlas después.
- Frescura: las respuestas exitosas de Meta se guardan 15 minutos; los errores no se guardan, así que reintentar después de un error vuelve a consultar a Meta (y cuenta en el límite).
fetched_atdice cuándo se leyó. - Límite: hasta 60 consultas a Meta por hora por cuenta, en una ventana de una hora que arranca con la primera consulta y se reinicia al cumplirse (
Retry-Afterindica cuántos segundos faltan); las respuestas guardadas no cuentan y una lectura puede usar hasta 3 consultas si Meta la entrega en varias páginas.
| HTTP | error | Cuándo |
|---|---|---|
| 404 | — | La plantilla no existe en tu cuenta. |
| 422 | template_metrics_not_available_for_qr | El número de la plantilla está conectado por QR. |
| 422 | template_not_in_meta | La plantilla todavía no tiene identificador en Meta. |
| 422 | number_not_connected_to_meta | El número no tiene cuenta de WhatsApp Business o credenciales válidas. |
| 422 | template_waba_mismatch | La plantilla es de otra cuenta de WhatsApp Business que la actual del número. |
| 422 | template_analytics_not_enabled | Las métricas de plantillas no están activadas en la cuenta. |
| 422 | template_analytics_not_available_yet | Meta todavía no tiene métricas para la cuenta. |
| 429 | template_metrics_rate_limited | Se agotaron las consultas a Meta de la hora (ver Retry-After). |
| 429 | — | Demasiadas solicitudes por minuto (ver Retry-After). |
| 503 | meta_rate_limited | Meta está limitando las consultas (ver Retry-After). |
| 502 | meta_unavailable | Meta no respondió correctamente. |
httpheader
AuthorizationBearer <clave>template*stringId opaco: un texto que empieza con tpl_. Se usa tal como llega; no se arma ni se interpreta.
Patrón
^tpl_[A-Za-z0-9]{23}$from?|Formato
dateto?|Formato
dateOK
application/json- response
data*curl -X GET "https://example.com/templates/tpl_AlgBF7nTNqV0atiwNuKFmT8/metrics"{ "data": { "template_id": "tpl_AlgBF7nTNqV0atiwNuKFmT8", "from": "string", "to": "string", "timezone": "UTC", "granularity": "day", "fetched_at": "string", "totals": { "property1": null, "property2": null }, "days": [ { "property1": null, "property2": null } ] }}