company logo

Central de ajuda

Entrar
Todas as coleçõesCX ConnectIntegração dos APPsWebhook e HTTP + CX Connect: a porta de entrada (e saída) universal

Webhook e HTTP + CX Connect: a porta de entrada (e saída) universal

Nem todo sistema tem conector pronto no CX Connect. Para esses casos existem dois conectores universais. O Webhook recebe dados de qualquer sistema, e o HTTP envia dados para qualquer sistema. Com eles, até a ferramenta interna da sua empre

Nem todo sistema tem conector pronto no CX Connect. Para esses casos existem dois conectores universais. O Webhook recebe dados de qualquer sistema, e o HTTP envia dados para qualquer sistema. Com eles, até a ferramenta interna da sua empresa entra no fluxo.

info icon
O CX Connect fica em cliente.customerx.com.br/connect, na aba Automações. Você pode ver as ações de cada app antes de conectar qualquer conta, e cada dado gravado consome uma transação do plano.

A ideia em uma frase

Pense no Webhook como um endereço de correspondência só seu. O CX Connect gera uma URL única e, toda vez que outro sistema envia dados para esse endereço, a automação dispara. O HTTP é o caminho contrário: a automação liga para o endereço de outro sistema e entrega os dados lá.

Quando usar

  • O app não está no catálogo: a plataforma que a sua empresa usa não tem conector pronto, mas sabe chamar uma URL quando algo acontece. A maioria das ferramentas modernas sabe, como formulários, plataformas de evento e sistemas de cobrança.

  • Sistema interno da empresa: aquele sistema feito em casa pode mandar dados para o CustomerX pelo Webhook ou receber dados pelo HTTP.

  • Caminho temporário: enquanto uma integração oficial não existe, o Webhook resolve o fluxo sem você esperar o roadmap de ninguém.

Como funciona o Webhook (entrada)

  1. Na automação, escolha o app Webhook como origem. O CX Connect gera uma URL única.

  2. Copie essa URL e cadastre no sistema de origem, no lugar onde ele permite notificar uma URL. Esse recurso costuma se chamar webhook, callback ou notificação HTTP.

  3. Peça para o sistema de origem fazer um envio de teste. Os dados que chegarem viram os campos disponíveis para o mapeamento.

  4. Mapeie os campos para a ação de destino, como criar tarefa ou atualizar cliente no CustomerX, e ative.

O formato dos dados que chegam define o que você consegue mapear. Por isso o envio de teste antes de mapear é obrigatório, não opcional.

Como funciona o HTTP (saída)

Escolha HTTP Request/Outgoing webhook como destino e informe o endereço do sistema que vai receber. A automação envia os dados a cada disparo do gatilho. Há também uma ação para baixar um arquivo a partir de uma URL.

Dicas para usar bem

  • Trate a URL do webhook como uma senha: qualquer pessoa ou sistema com esse endereço consegue disparar a sua automação e injetar dados. Não compartilhe em documentos abertos.

  • Chame o time técnico para configurar a origem: gerar a URL no CX Connect é simples, mas cadastrá-la no sistema de origem costuma exigir alguém com acesso de administrador lá.

  • Combine o identificador do cliente no envio: peça a quem configura a origem para sempre incluir o e-mail, o CNPJ ou o ID. Sem isso, o CX Connect não sabe a qual cliente o dado pertence.

  • Teste com dado real: dispare um envio verdadeiro do sistema de origem e confira o resultado no destino antes de ativar.

Gatilhos e ações disponíveis

Webhook, gatilho: webhook de entrada (Incoming webhook), a URL única que dispara a automação ao receber dados. Este conector não tem ações.

HTTP Request/Outgoing webhook, ações: enviar requisição (Send request) e obter arquivo por URL (Get file by URL). Este conector não tem gatilhos.

info icon
Fonte: catálogo público da Albato (albato.com/apps/webhooks e albato.com/apps/http). Os nomes podem variar um pouco na tela do CX Connect, e a lista evolui com o tempo. Para ver a versão atual, escolha o conector na sua automação.

Artigos relacionados

Mapeamento de campos

Como ligar os campos da ferramenta de origem aos campos do CustomerX para que os dados entrem no lugar certo.

Solução de problemas e FAQ

O que checar quando uma automação não funciona como esperado, e as dúvidas mais comuns sobre o CX Connect.

Esta resposta foi útil?
😞
😐
😁