Skip to main content
GET
Consultar confirmaciones de WhatsApp

Authorizations

Authorization
string
header
required

Llave existente con permiso whatsapp_events:read.

Query Parameters

dateFrom
string<date-time>

Inicio inclusivo sobre receivedAt. ISO 8601 con segundos y zona horaria; omitir para no limitar el inicio. Para el histórico usa días completos de Caracas desde 00:00:00-04:00. Sin ambos límites, consulta todo el histórico disponible.

dateTo
string<date-time>

Fin inclusivo sobre receivedAt. Debe ser igual o posterior a dateFrom. Incluye segundos y zona horaria. Para incluir un día histórico completo termina en 23:59:59.999-04:00; un corte parcial excluye ese día histórico.

phone
string

Coincidencia parcial del teléfono del destinatario, como en el panel. Excluye el histórico agregado, que no tiene destinatarios; report.history.availability será unsupported_filter.

Maximum string length: 64
status
enum<string>

Filtra events, summary, report.summary y report.daily; los otros estados quedan en cero. read o failed excluyen el histórico agregado. report.history conserva metadatos de procedencia y no debe sumarse a report.summary.

Available options:
sent,
delivered,
read,
failed
page
integer
default:1

Página solicitada, incluso si queda fuera del resultado. Sólo pagina events; ambos resúmenes y report.daily cubren todo el resultado filtrado.

Required range: 1 <= x <= 90071992547409
limit
integer
default:20

Cantidad máxima de eventos por página.

Required range: 1 <= x <= 100

Response

Detalle paginado y reporte combinado del filtro completo en una misma instantánea. Una página vacía conserva los totales; el histórico puede existir aunque events esté vacío.

events
object[]
required
summary
object
required

Totales del detalle original: cuenta eventos almacenados, incluidos callbacks repetidos. Para tarjetas con histórico usa report.summary.

page
integer
required
Required range: x >= 1
limit
integer
required
Required range: 1 <= x <= 100
totalPages
integer
required
Required range: x >= 0
coverage
object
required

Coverage of observed confirmed events only. Zero does not mean no messages were sent. Historical attribution and callback availability may be incomplete.

report
object

Unified dashboard. Imported sender/day totals replace overlapping message/status observations. Original summary and events remain callback counts. Unknown historical reads and failures are null.