FAQ - Webhook

1 Como verificar protocolos - Central de Hooks
2 Status 200 com erro no body Webhook
- 2.1 1. O que significa esse erro?
- 2.2 2. Por que isso acontece?
- 2.3 3. Como resolver?
- 2.4 4. Como evitar no futuro?

Esta documentação abrange a área de troubleshooting, essencial para resolver problemas técnicos e manter sistemas funcionando adequadamente. Exploraremos a abordagem sistemática de análise de sintomas, testes e diagnóstico, além de destacar a importância da colaboração e compartilhamento de conhecimento. O guia fornece informações valiosas para aprimorar habilidades técnicas e enfrentar desafios com confiança, garantindo a eficiência operacional. Mantenha-se atualizado com as últimas tendências nesse campo em constante evolução.

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Como verificar protocolos - Central de Hooks

Para verificar os protocolos enviados via Webhook, é possível utilizar a ferramenta de Central de Hooks diretamente no Painel de configuração.

Para acessar, vá em:
Ferramentas > Central de Hooks.

Nela, é possível obter as informações de Webhooks que foram enviados corretamente ou não com base em uma busca utilizando os filtros disponíveis.

Após realizar a busca e localizar o Protocolo desejado, acesse o mesmo para verificar as informações que estão sendo enviada e também o Status (hook) se o mesmo foi bem sucedido ou não.

Caso de Webhook bem sucedido com Status 200 e body correto.

Pode haver casos onde o Status do hook está com sucesso (200) porém, o body não está correto, ocasionando erro no envio deste Protocolo.

Caso de Webhook com Status 200 e body incorreto

Nesses casos, o Protocolo não será enviado corretamente!

Caso seu sistema receba um webhook com status 200, mas o body indique um erro, siga este guia para diagnóstico e correção.

Status 200 com erro no body Webhook

1. O que significa esse erro?

Status 200: O servidor recebeu o webhook corretamente.
Body com erro: Indica que a mensagem foi recebida, mas não pôde ser processada devido a um problema nos dados.

Exemplo de resposta com erro:

json

{
  "data": {
    "status": false,
    "mensagem": "Tabela informada [41] inválida"
  },
  "status": 200
}

2. Por que isso acontece?

Possíveis causas:
✔ ID inválido: O número 41 não existe ou não está cadastrado no sistema.
✔ Formato incorreto: O campo espera um texto (ex.: "padrao") em vez de um número.

3. Como resolver?

Passo 1: Verifique o payload enviado

Confira se o campo relacionado à tabela está no formato correto.

Exemplo de payload incorreto:jso

{
  "tabela_id": 41  // Número inválido
}

Passo 2: Consulte a documentação de Webhook

Verifique quais valores são aceitos em nossa documentação:
Webhook

Passo 3: Teste manualmente (Postman/cURL)

Envie uma requisição ajustada para confirmar se o erro persiste:

bash

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"tabela_id": 1}' \
  https://seusistema.com/webhook

4. Como evitar no futuro?

✔ Valide os dados antes de enviar

Confira se os IDs de tabela existem no sistema.
Verifique se o formato (número/texto) está correto.

✔ Implemente logs de erro
Registre respostas com status: false para análise posterior.

✔ Monitore respostas de webhook
Configure alertas para avisar quando houver erros no body, mesmo com status 200.