Reenvío Masivo de Notificaciones

Utilice este endpoint para el reenvío masivo de notificaciones de webhook según un conjunto de filtros.

Entornos Disponibles

Producción

https://api.gateway.com.br/dispatcher

Endpoint

• Método: POST
• Endpoint: /request/resend
• Autenticación: Bearer token

Reglas del Body

ℹ️ Reglas condicionales

Debe enviar una de las opciones siguientes:

• startDate + endDate (cuando no se envía referenceId)
• referenceId (cuando no se envían startDate ni endDate)

Para cubrir todos los campos del DTO, use los ejemplos completos de los dos escenarios de abajo.

ℹ️ Las fechas no pueden ser futuras

Los campos startDate y endDate deben ser fechas ISO 8601 válidas y no futuras.

Ejemplo:

• 2026-03-24T00:00:00Z

Nombre	Tipo	Obligatorio	Descripción	Validaciones
startDate	string (ISO 8601)	Condicional	Fecha inicial del filtro	Obligatorio cuando no se envía referenceId. No puede ser futura
endDate	string (ISO 8601)	Condicional	Fecha final del filtro	Obligatorio cuando no se envía referenceId. No puede ser futura
referenceId	string	Condicional	ID de referencia de una notificación específica	Obligatorio cuando no se envían startDate ni endDate
status	string[] (enum) - RECEIVED, SENT, FAILED, ERROR	No	Lista de estados para el filtro	Debe ser un arreglo no vacío
tags	string[]	No	Lista de etiquetas para el filtro	Arreglo no vacío, como máximo 10 elementos
overrideURL	string (URL)	No	URL que sustituye la URL de destino actual de la notificación en el reenvío (a dónde se enviará la notificación)	Debe ser una URL válida

Ejemplo de Solicitud (escenario startDate + endDate)

cURL

curl --request POST \
--url https://api.gateway.com.br/dispatcher/request/resend \
--header 'Authorization: Bearer su-token-jwt' \
--header 'Content-Type: application/json' \
--data '{
  "startDate": "2026-03-23T00:00:00Z",
  "endDate": "2026-03-24T23:59:59Z",
  "status": ["RECEIVED", "SENT", "FAILED", "ERROR"],
  "tags": ["webhook", "notification"],
  "overrideURL": "https://api.example.com/webhooks/custom-callback"
}'

JavaScript

const payload = {
  startDate: '2026-03-23T00:00:00Z',
  endDate: '2026-03-24T23:59:59Z',
  status: ['RECEIVED', 'SENT', 'FAILED', 'ERROR'],
  tags: ['webhook', 'notification'],
  overrideURL: 'https://api.example.com/webhooks/custom-callback'
};

const response = await fetch('https://api.gateway.com.br/dispatcher/request/resend', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer su-token-jwt',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});

Ejemplo de Solicitud (escenario referenceId)

cURL

curl --request POST \
--url https://api.gateway.com.br/dispatcher/request/resend \
--header 'Authorization: Bearer su-token-jwt' \
--header 'Content-Type: application/json' \
--data '{
  "referenceId": "123e4567-e89b-12d3-a456-426614174001",
  "status": ["RECEIVED", "SENT", "FAILED", "ERROR"],
  "tags": ["webhook", "notification"],
  "overrideURL": "https://api.example.com/webhooks/custom-callback"
}'

JavaScript

const payload = {
  referenceId: '123e4567-e89b-12d3-a456-426614174001',
  status: ['RECEIVED', 'SENT', 'FAILED', 'ERROR'],
  tags: ['webhook', 'notification'],
  overrideURL: 'https://api.example.com/webhooks/custom-callback'
};

const response = await fetch('https://api.gateway.com.br/dispatcher/request/resend', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer su-token-jwt',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});

Respuesta Exitosa

Código	Descripción
201 Created	Solicitud aceptada para el procesamiento del reenvío

ℹ️ Cuerpo de la respuesta

Este endpoint devuelve 201 y no tiene payload de respuesta.

Errores Posibles

Código	Descripción	Solución
400	Solicitud inválida	Verifique el formato del body y las reglas condicionales
401	Credenciales inválidas	Verifique su token
403	Sin permiso/autorización	Verifique el alcance resend_dispatcher
422	Entidad no procesable	Revise los campos y las validaciones
500	Error interno	Contacte al soporte