O webhook não recebe relatórios nem respostas

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.

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.
• 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.

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. 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.

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 com o assunto API e envie:

• o ID da mensagem da mensagem original (consulte 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.

De que endereços IP vem o webhook?

Se precisar de autorizar os nossos servidores na sua firewall, escreva-nos 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.