Quando os relatórios de entrega ou as SMS recebidas (respostas) não chegam ao seu webhook, a causa está normalmente nas definições da aplicação no portal ou no seu servidor. Abaixo encontra como identificar o problema e o que enviar ao suporte, se isso não ajudar.

## O webhook está definido na aplicação certa?

O webhook é definido separadamente para cada aplicação (API). Se envia através de várias aplicações ou carteiras, verifique aquela através da qual as suas mensagens são realmente enviadas.

1. No portal, abra `Módulos e APIs`.
2. Em `Minhas APIs e módulos`, abra o cartão da aplicação.
3. No separador `Definições`, verifique o bloco `Relatórios de entrega` na secção `Web hooks`.

Se o bloco mostrar `Você não tem configurações.`, não há nenhum webhook definido. O procedimento está em [Webhook](https://www.bulkgate.com/pt/documentacao/administracao-da-api/webhooks/).

![A secção Web hooks no detalhe da aplicação, com o bloco Relatórios de entrega e as opções Reportar apenas quando ocorrer erro e DLRs em massa](helpdesk:webhook-not-working/webhook-settings_en)

> [!NOTE]
> Os relatórios de entrega e as SMS recebidas vão para **um único endereço**. Reconhece as SMS recebidas pelo `status` `10`. Não existe um URL separado para as respostas.

## A opção "reportar apenas em caso de erro" está ativada?

A opção `Reportar apenas quando ocorrer erro` só envia um relatório de entrega para as mensagens que falharam. Para as mensagens entregues, não chega nada. Se pretende receber todos os relatórios de entrega, desative a opção.

## Está à espera do formato de dados correto?

- **Modo predefinido:** um pedido por mensagem, com o método GET. O formato está descrito em [Confirmações de entrega](https://www.bulkgate.com/pt/documentacao/administracao-da-api/api-confirmacoes-de-entrega-e-sms-recebidos/).
- **`DLRs em massa - solicitação em massa`:** um lote de registos com o método POST e `application/json`. O formato está descrito em [Confirmações de entrega em massa](https://www.bulkgate.com/pt/documentacao/administracao-da-api/api-confirmacoes-de-entrega-em-massa-e-mensagens-recebidas/).

Se o seu servidor espera outro formato, o pedido chega, mas a sua aplicação não o processa.

## O seu servidor responde corretamente?

- O endereço tem de estar acessível a partir da Internet e começar por `http://` ou `https://`.
- O servidor tem de responder rapidamente e com o código de estado `200`. Um processamento lento ou com erros atrasa a entrega dos relatórios seguintes. Passe o trabalho pesado para uma fila e confirme o pedido de imediato.
- Uma firewall ou uma proteção contra bots não pode bloquear os nossos pedidos. Verifique os registos (logs) do seu servidor. Os pedidos chegaram e com que resposta?

## Porque não chegam as SMS recebidas?

As respostas só chegam quando a mensagem foi enviada com um tipo de remetente que suporta SMS bidirecionais no país do destinatário. Saiba mais em [Número SMS dedicado e receção de respostas](https://www.bulkgate.com/pt/centro-de-ajuda/sms/numero-dedicado-sms/). Com um número próprio e com o Mobile Connect, as respostas vão para o seu telemóvel e não para o webhook.

> [!WARNING]
> Se eliminar o webhook, deixam de chegar tanto os relatórios de entrega como as respostas.

## O que enviar ao suporte

Se já seguiu os pontos acima e os dados continuam a não chegar, escreva-nos através do [formulário de contacto](https://www.bulkgate.com/pt/contacto/) com o assunto **API** e envie:

- o **ID da mensagem** da mensagem original (consulte [ID da mensagem](https://www.bulkgate.com/pt/centro-de-ajuda/informacoes-gerais/id-da-mensagem/)),
- o **URL** que definiu para os relatórios de entrega,
- no caso das SMS recebidas, uma **captura de ecrã do telemóvel** onde se vejam a hora e o texto da resposta,
- o que vê no registo do seu servidor, ou seja, se o pedido não chegou ou se chegou com um erro.

## Perguntas frequentes

### Como funcionam os relatórios de entrega de SMS?

Um relatório de entrega (confirmação de entrega) indica o que aconteceu à mensagem na rede do operador, ou seja, se foi entregue ou não. A BulkGate guarda o estado com a mensagem, pelo que o pode ver no histórico de mensagens no portal. Se a aplicação tiver um webhook definido para `Relatórios de entrega`, o relatório também é enviado para o seu URL. As confirmações chegam normalmente em poucos minutos. O significado de cada estado está descrito em [A mensagem não foi entregue](https://www.bulkgate.com/pt/centro-de-ajuda/informacoes-gerais/mensagem-nao-entregue/).

### De que endereços IP vem o webhook?

Se precisar de autorizar os nossos servidores na sua firewall, [escreva-nos](https://www.bulkgate.com/pt/contacto/) com o assunto **API**.

### Posso receber os relatórios de entrega por e-mail?

Com a interface Email > SMS, os relatórios de entrega são enviados por e-mail para `Relatórios de entrega de e-mail` e não para um URL.