Ir para o conteúdo

Webhooks

Um webhook é uma mensagem automatizada de um sistema para outro após determinados critérios serem atendidos. Na Braze, esse critério geralmente é o disparo de um evento personalizado. Os webhooks oferecem acesso dinâmico e flexível a dados e funcionalidades programáticas, e permitem que você configure jornadas de clientes que otimizam processos.

Pré-requisitos

A disponibilidade de webhooks depende do seu pacote da Braze. Entre em contato com seu gerente de conta ou gerente de sucesso do cliente para começar.

Casos de uso

Webhooks são uma excelente forma de conectar seus sistemas. Afinal, é por meio de webhooks que os apps se comunicam. Aqui estão alguns cenários gerais em que os webhooks podem ser especialmente úteis:

  • Enviar dados para a Braze e a partir dela
  • Enviar mensagens aos seus clientes por canais que não são diretamente compatíveis com a Braze
  • Fazer publicações nas APIs da Braze

Alguns casos de uso mais específicos incluem:

  • Criar um fluxo de trabalho de pontuação de leads usando webhooks e Canvas para qualificar e encaminhar leads.
  • Se um usuário cancelar a inscrição de e-mail, você pode fazer com que um webhook atualize seu banco de dados de análise de dados ou CRM com essa mesma informação. Assim, você garante uma visão completa do comportamento desse usuário.
  • Enviar mensagens transacionais aos usuários no Facebook Messenger ou no LINE.
  • Enviar mala direta aos clientes em resposta à atividade deles no app e na web, usando webhooks para se comunicar com serviços de terceiros como o Lob.com.
  • Se um jogador atingir um determinado nível ou acumular um certo número de pontos, use webhooks e sua configuração de API existente para enviar um upgrade de personagem ou moedas diretamente para a conta dele. Se você enviar o webhook como parte de uma campanha de mensagens em vários canais, pode enviar ao mesmo tempo um push ou outra mensagem para avisar o jogador sobre a recompensa.
  • Se você é uma companhia aérea, pode usar webhooks e sua configuração de API existente para creditar um desconto na conta de um cliente depois que ele reservar um determinado número de voos.
  • Infinitas receitas “If This Then That” (IFTTT). Por exemplo, se um cliente entrar no app por e-mail, esse endereço pode ser configurado automaticamente no Salesforce.

Tratamento de erros de webhook e limite de frequência

A Braze tenta reenviar o webhook apenas para determinadas respostas HTTP (por exemplo, 408, 429 e 5XX). A maioria das outras respostas, incluindo 401 Unauthorized e outros erros 4XX, não é reenviada. Cabeçalhos de resposta como Retry-After e X-Rate-Limit-* podem influenciar o tempo de espera entre tentativas quando a resposta já é elegível para uma nova tentativa. Eles não fazem a Braze tentar novamente erros que estão fora desse conjunto.

Para ver a tabela completa de códigos de resposta, os limites de novas tentativas e o comportamento de tempo limite, confira Códigos de resposta e lógica de novas tentativas.

Se a maioria das solicitações de webhook para um host específico estiver falhando, a Braze adia temporariamente todas as tentativas de envio para esse host. O envio é retomado após um período de espera definido, o que dá tempo para o seu sistema se recuperar.

Usando webhooks com parceiros da Braze

Existem muitas formas de usar webhooks. Com nossos parceiros de tecnologia (Alloys), você pode usar webhooks para melhorar sua comunicação diretamente com seus clientes e usuários.

Confira:

Próximas etapas

New Stuff!