Além de enviar mensagens e marcar (ou desmarcar) seus clientes, agora você pode orquestrar ações e workflows em outros apps e sistemas com webhooks em Series.
Com webhooks em Series, você pode usar qualquer evento ou conjunto de filtros no Intercom para fazer coisas como:
Manter os dados dos clientes sincronizados entre múltiplos sistemas.
Enviar notificações internas para sua equipe quando users alcançarem um marco em uma Series.
Fazer atualizações no seu próprio app customizado ou banco de dados.
O que é um webhook?
Um webhook é uma mensagem enviada do Intercom quando um user corresponde aos critérios que você especificar (como completar um evento). Ela contém uma mensagem — ou “payload” — e é enviada para uma URL única de sua escolha.
Por exemplo, esta é uma série simples que envia um webhook após um user realizar uma certa ação:
O webhook contém o nome do user, nome da empresa e ID. O payload do webhook se parece com isto:
POST https://examply.io/webhooks
Content-Type: application/json
{
name: “Lonnie Lynn”
company: “CSense Ltd”
company_id: “c0m5en5e”
}
O aplicativo que recebe o webhook pode então fazer algo (ou muitas coisas) com os dados no payload. 👌
Nota: Enviar webhooks com Series está disponível apenas em certos planos do Intercom. Veja nossos planos e preços aqui.
Como adicionar um webhook a uma series
Arraste um webhook do menu à direita e conecte-o à sua series após qualquer bloco de regra que você queira para dispará-lo:
Abra o bloco do webhook e dê um título:
Agora você pode configurar exatamente quais dados enviar e para onde enviá-los.
Dica profissional: Se estiver enviando um webhook para outro aplicativo (como Zapier, por exemplo), geralmente você pode encontrar o tipo de requisição, a URL do webhook e quaisquer cabeçalhos necessários na documentação deles. Se você estiver enviando um webhook para seu próprio app, seus engenheiros devem ser capazes de fornecer essas informações. 👌 |
Vamos começar com o método HTTP e a URL do webhook:
Para o método, você pode escolher entre PUT ou POST, e a URL é para o app que deve receber o webhook.
Dica: Você pode usar RequestBin ou um serviço similar ao testar.
Em seguida, adicione quaisquer cabeçalhos do webhook como pares chave-valor:
Apenas o cabeçalho Content-Type é obrigatório para enviar um webhook (JSON ou URLencoded), porém, cabeçalhos adicionais podem ser necessários para receber o webhook.
Por exemplo, pode ser necessário autenticar com o app receptor.
Para adicionar novos cabeçalhos, basta clicar em “+ Adicionar um par chave-valor”:
Opcionalmente, selecione os dados para incluir no corpo do webhook como pares chave-valor. Neste exemplo, estamos enviando o nome, nome da empresa e ID da empresa.
Para dados dinâmicos, adicione atributos do Intercom com o menu “{...}”:
Testando seu webhook
Antes de ativar sua series, recomendamos testar seu webhook para garantir que ele envie e seja recebido conforme esperado. Clique em “Testar”:
Digite o nome ou endereço de email de um user de teste para que você possa ver os dados dele preenchidos no payload do webhook:
Então selecione-o e clique em “Executar teste”:
Você verá a resposta retornada do app receptor:
Nota: Você deve ver um código de sucesso “200”, qualquer outro código pode exigir alguma solução de problemas com o app receptor.
O que acontece se um webhook falhar?
Se um webhook for bem-sucedido, registramos uma estatística “Enviado”. Se falhar, tentaremos enviá-lo mais 2 vezes. Após a terceira tentativa, o ponto de verificação será marcado como “Falhou”. Você pode ver esses resultados clicando no webhook quando sua series estiver ativa. 👍