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
/templates/{template}/metrics

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: from y to (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; to no 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 cost en null.
  • 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: null cuando 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_at dice 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-After indica 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.
HTTPerrorCuándo
404—La plantilla no existe en tu cuenta.
422template_metrics_not_available_for_qrEl número de la plantilla está conectado por QR.
422template_not_in_metaLa plantilla todavía no tiene identificador en Meta.
422number_not_connected_to_metaEl número no tiene cuenta de WhatsApp Business o credenciales válidas.
422template_waba_mismatchLa plantilla es de otra cuenta de WhatsApp Business que la actual del número.
422template_analytics_not_enabledLas métricas de plantillas no están activadas en la cuenta.
422template_analytics_not_available_yetMeta todavía no tiene métricas para la cuenta.
429template_metrics_rate_limitedSe agotaron las consultas a Meta de la hora (ver Retry-After).
429—Demasiadas solicitudes por minuto (ver Retry-After).
503meta_rate_limitedMeta está limitando las consultas (ver Retry-After).
502meta_unavailableMeta no respondió correctamente.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

template*string

Id 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}$

Parámetros de consulta

from?|
Formatodate
to?|
Formatodate

Cuerpo de la respuesta

OK

application/json
  1. 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      }    ]  }}

Esto es lo que se copia para tu IA

Cargando…