Reenviar Notificações em Massa

Utilize este endpoint para reenvio em massa de notificações de webhook com base em filtros.

Ambientes Disponíveis

Produção

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

Endpoint

• Método: POST
• Endpoint: /request/resend
• Autenticação: Bearer token

Regras do Body

ℹ️ Regras condicionais

Você deve enviar uma das opções abaixo:

• startDate + endDate (quando referenceId não for informado)
• referenceId (quando startDate e endDate não forem informados)

Para cobrir todos os campos do DTO, use os exemplos completos dos dois cenários abaixo.

ℹ️ Datas não podem ser futuras

Os campos startDate e endDate devem ser datas ISO 8601 válidas e não futuras.

Exemplo:

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

Nome	Tipo	Obrigatório	Descrição	Validações
startDate	string (ISO 8601)	Condicional	Data inicial para filtro	Obrigatório quando referenceId não é enviado. Não pode ser futura
endDate	string (ISO 8601)	Condicional	Data final para filtro	Obrigatório quando referenceId não é enviado. Não pode ser futura
referenceId	string	Condicional	ID de referência de uma notificação específica	Obrigatório quando startDate e endDate não são enviados
status	string[] (enum) - RECEIVED, SENT, FAILED, ERROR	Não	Lista de status para filtro	Deve ser array não vazio
tags	string[]	Não	Lista de tags para filtro	Array não vazio, no máximo 10 itens
overrideURL	string (URL)	Não	URL que substitui a URL atual de destino da notificação no reenvio (para onde a notificação será enviada)	Deve ser URL válida

Exemplo de Requisição (cenário startDate + endDate)

cURL

curl --request POST \
--url https://api.gateway.com.br/dispatcher/request/resend \
--header 'Authorization: Bearer seu-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 seu-token-jwt',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});

Exemplo de Requisição (cenário referenceId)

cURL

curl --request POST \
--url https://api.gateway.com.br/dispatcher/request/resend \
--header 'Authorization: Bearer seu-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 seu-token-jwt',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(payload)
});

Resposta de Sucesso

Código	Descrição
201 Created	Requisição aceita para processamento de reenvio

ℹ️ Corpo da resposta

Este endpoint retorna 201 e não possui payload de resposta.

Possíveis Erros

Código	Descrição	Solução
400	Requisição inválida	Verifique formato do body e regras condicionais
401	Credenciais inválidas	Verifique seu token
403	Sem permissão/autorização	Verifique o escopo resend_dispatcher
422	Entidade não processável	Revise os campos e validações
500	Erro interno	Contate o suporte