Webhook de Notificação de Relatórios

Configuração: POST /whatsapp/config/ com o campo url_report_webhook

Webhook automático enviado quando relatórios são processados. O webhook inclui a URL direta para download do arquivo com token temporário (válido por 24h).

Como configurar

Configure a URL do webhook via POST /whatsapp/config/ com o campo url_report_webhook
Quando um relatório for criado via qualquer endpoint de /reports/, você receberá uma notificação
O webhook inclui a URL direta para download do arquivo com token temporário (válido por 24h)

Eventos

Evento	Descrição
`report.ready`	Relatório processado com sucesso e pronto para download.
`report.error`	Erro no processamento do relatório.

Tipos de relatório

Tipo	Descrição
`licenses`	Relatório de licenças
`numbers`	Relatório de números
`templates`	Relatório de templates
`official-messages`	Relatório de mensagens oficiais
`attendance-history`	Histórico de atendimento
`attendance-statistics`	Estatísticas de atendimento
`tickets-summary`	Resumo de tickets
`ticket-detail`	Detalhe de ticket

Payload - report.ready

Campo	Tipo	Descrição
`event_id`	string (uuid)	Identificador único do evento (UUID v4).
`event`	string	`"report.ready"`
`report_id`	integer	ID único do relatório.
`report_type`	string	Tipo do relatório gerado.
`report_name`	string	Nome do arquivo do relatório.
`status`	string	`"ready"`
`file_url`	string	URL para download do arquivo.
`company_id`	integer	ID da empresa que solicitou.
`created_at`	string (date-time)	Data e hora de criação.

Exemplo - report.ready

{
  "event_id": "g20eff00-pd9m-d2o5-l827-ff7766ff1111",
  "event": "report.ready",
  "report_id": 123,
  "report_type": "official-messages",
  "report_name": "mensagens_01072025-31072025_17_09_2025_14_30_45_abc",
  "status": "ready",
  "file_url": "/reports/123/download/",
  "company_id": 26,
  "created_at": "2025-09-17T16:10:11.138957Z"
}

Payload - report.error

Campo	Tipo	Descrição
`event_id`	string (uuid)	Identificador único do evento (UUID v4).
`event`	string	`"report.error"`
`report_id`	integer	ID único do relatório.
`report_type`	string	Tipo do relatório que falhou.
`report_name`	string	Nome do arquivo do relatório.
`status`	string	`"error"`
`error_message`	string	Mensagem descritiva do erro.
`company_id`	integer	ID da empresa que solicitou.
`created_at`	string (date-time)	Data e hora de criação.

Exemplo - report.error

{
  "event_id": "h30f0g10-qe0n-e3p6-m938-gg8877gg2222",
  "event": "report.error",
  "report_id": 123,
  "report_type": "official-messages",
  "report_name": "mensagens_01072025-31072025_17_09_2025_14_30_45_abc",
  "status": "error",
  "error_message": "Connection timeout to database",
  "company_id": 26,
  "created_at": "2025-09-17T16:10:11.138957Z"
}