Solução de problemas de solicitações de webhook e Connected Content

Este artigo aborda como solucionar problemas de códigos de erro comuns para webhooks e Connected Content e fornece explicações adicionais sobre como esses erros podem ocorrer em suas solicitações.

Erros 4XX

4XX indicam que há um problema com a solicitação enviada ao endpoint. Esses erros geralmente são causados por solicitações errôneas, incluindo parâmetros malformados, cabeçalhos de autenticação ausentes ou URLs incorretos.

Consulte a tabela a seguir para obter detalhes sobre o código de erro e as etapas de resolução:

Código de erro	O que isso significa	Etapas para resolver
400 Solicitação incorreta	Há uma sintaxe inválida na solicitação.	Verifique se há erros de sintaxe na carga útil da solicitação. Confirme se todos os campos obrigatórios foram incluídos e formatados corretamente. Se estiver enviando uma carga útil JSON, valide a estrutura JSON.
401 Não autorizado	A solicitação requer autenticação do usuário.	Verifique se as credenciais de autenticação corretas (como chaves ou tokens de API) estão incluídas nos cabeçalhos da solicitação. Confirme que você tem as permissões de usuário para acessar o endpoint.
403 Proibido	O ponto de extremidade entende a solicitação, mas se recusa a autorizá-la.	Verifique se a chave ou o token da API tem as permissões necessárias. Confirme que você tem as permissões de usuário para acessar o endpoint.
404 Não encontrado	O ponto de extremidade não consegue encontrar o recurso solicitado.	Verifique se há erros de digitação ou jornadas incorretas no URL do endpoint. Confirme se o recurso que está tentando acessar existe.
405 Método não permitido	O método de solicitação é conhecido pelo ponto de extremidade, mas não é compatível com o recurso de direcionamento.	Verifique o método HTTP (DELETE, GET, POST, PUT) usado na solicitação. Confirme se o ponto de extremidade é compatível com o método que você está usando.
408 Tempo limite da solicitação	O ponto de extremidade atingiu o tempo limite de processamento da solicitação.	Verifique o método HTTP (DELETE, GET, POST, PUT) usado na solicitação. Confirme se o ponto de extremidade é compatível com o método que você está usando.
409 Conflito	A solicitação está incompleta devido a um conflito com o estado atual do recurso.	Verifique o método HTTP (DELETE, GET, POST, PUT) usado na solicitação. Confirme se o ponto de extremidade é compatível com o método que você está usando.
429 Solicitações em excesso	Há um número excessivo de solicitações enviadas em um determinado período de tempo.	Reduza o limite de frequência em sua campanha ou etapa do Canva.

Erros 5XX

5XX indicam que há um problema com o endpoint. Esses erros geralmente são causados por problemas no lado do servidor.

Código de erro	O que isso significa
Erro interno do servidor 500	O endpoint encontrou uma condição inesperada que o impediu de concluir a solicitação.
502 Gateway ruim	O ponto de extremidade recebeu uma resposta inválida do servidor upstream.
503 Serviço indisponível	O ponto de extremidade não está conseguindo processar a solicitação devido a uma sobrecarga temporária ou manutenção.
504 Tempo limite do gateway	O ponto de extremidade não recebeu uma resposta oportuna do servidor upstream.
529 Host sobrecarregado	O host do endpoint está sobrecarregado e não pôde responder.
598 Host não saudável	O Braze simulou a resposta porque o host do endpoint está temporariamente marcado como não saudável. Consulte Detecção de host não saudável para saber mais.
599 Erro de conexão	O Braze apresentou um erro de tempo limite de conexão de rede ao tentar estabelecer uma conexão com o endpoint, o que significa que o endpoint pode estar instável ou inativo.

Resolução de erros 5XX

Aqui estão algumas dicas para solucionar erros comuns do site 5XX:

• Revise a mensagem de erro para obter detalhes específicos disponíveis no registro de atividades de mensagens. Para webhooks, acesse a seção Performance ao longo do tempo na página inicial do Braze e selecione as estatísticas para webhooks. Aqui, você pode encontrar o registro de data e hora que indica quando os erros ocorreram.
• Certifique-se de que não esteja enviando muitas solicitações que sobrecarreguem o endpoint. Você pode enviar em lotes ou ajustar o limite de frequência para verificar se isso reduz os erros.

Detecção de host não saudável

Os webhooks do Braze e o Connected Content empregam um mecanismo de detecção de host insalubre para detectar quando o host de destino apresenta uma alta taxa de lentidão significativa ou sobrecarga, resultando em tempos limite, excesso de solicitações ou outros resultados que impedem que o Braze se comunique com sucesso com o endpoint de destino. Ele atua como uma salvaguarda para reduzir a carga desnecessária que pode estar causando dificuldades ao host de destino. Ele também serve para estabilizar a infraestrutura do Braze e manter velocidades rápidas de envio de mensagens.

Em geral, se o número de falhas exceder 3.000 em qualquer janela de tempo móvel de um minuto (por combinação exclusiva de nome de host e grupo de app - não por jornada de endpoint), o Braze interromperá temporariamente as solicitações ao host de destino por um minuto, simulando respostas com um código de erro 598 para indicar a integridade ruim. Após um minuto, o Braze retomará as solicitações em velocidade máxima se o host for considerado saudável. Se o host ainda não estiver saudável, o Braze aguardará mais um minuto antes de tentar novamente.

Os códigos de erro a seguir contribuem para a contagem de falhas do detector de host não íntegro: 408, 429, 502, 503, 504, 529.

Para webhooks, o Braze repetirá automaticamente as solicitações HTTP que foram interrompidas pelo detector de host não saudável. Essa nova tentativa automática usa backoff exponencial e tentará apenas algumas vezes antes de falhar. Para saber mais sobre erros de webhook, consulte Erros, lógica de repetição e tempos limite.

Para o Connected Content, se as solicitações ao host de destino forem interrompidas pelo detector de host não saudável, o Braze continuará a renderizar mensagens e a seguir sua lógica Liquid como se tivesse recebido um código de resposta de erro. Se você quiser garantir que essas solicitações de Connected Content sejam repetidas quando forem interrompidas pelo detector de host não saudável, use a opção :retry. Para saber mais sobre a opção :retry, consulte Tentativas de Connected Content.

Se achar que a detecção de host não saudável pode estar causando problemas, entre em contato com o suporte da Braze.

Envio de e-mails automatizados e registros de atividade de mensagens

Configuração de e-mails automatizados

Se ocorrerem mais de 100.000 erros de webhook ou de endpoint Connected Content (incluindo novas tentativas) em um espaço de trabalho em um período de 24 horas, você receberá um e-mail com as seguintes informações sobre como resolver os erros.

• Nome do espaço de trabalho
• Um link para o Canva ou a campanha
• URL do ponto de extremidade
• Código de erro
• Hora em que o erro foi observado pela última vez
• Links para o registro de atividades de mensagens e documentação relacionada

Os erros do ponto de extremidade são:

• 4XX: 400, 401, 403, 404, 405, 408, 409, 429
• 5XX: 500, 502, 503, 504, 598, 599

Esses e-mails são enviados apenas uma vez por dia no nível do espaço de trabalho. Se nenhum usuário inscrever-se para receber esses e-mails, todos os administradores da empresa serão notificados.

Para inscrever-se para receber esses e-mails, faça o seguinte:

1. Acesse Configurações > Configurações administrativas > Preferências de notificação.
2. Selecione Erros de conteúdo conectado e Erros de webhook na seção Canvas & Campaigns.

Entradas do registro de atividade de mensagens

Haverá pelo menos uma entrada no registro de atividades de mensagens relacionada ao erro que disparou o e-mail automático.