Como integrar plataformas externas à Avantto via Webhook

Etapa 1: Acessando o Workflow no Avantto

1. Faça login no Avantto : Utilize suas credenciais para acessar a plataforma Avantto.

2. Navegue até a seção de workflows : Geralmente, isso pode ser feito através do menu principal ou de automações.

3. Crie um novo workflow ou edite um existente : Se estiver criando um novo workflow, clique no botão para adicionar um novo. Caso esteja editando um existente, selecione-o e entre em modo de edição.

Etapa 2: Adicionando um Novo Gatilho (Trigger)

1. Localize a opção para adicionar um novo gatilho : Na interface do construtor de workflows, procure por um botão ou ícone que permita adicionar um novo trigger.

2. Selecione "Inbound Webhook" : Dos triggers disponíveis, escolha o "Inbound Webhook" para receber dados de uma plataforma externa.

3. Dê um nome ao gatilho : Por exemplo, "Inbound Webhook" para identificá-lo facilmente.

Etapa 3: Obtendo a URL do Webhook

1. Copie a URL fornecida : Após configurar o trigger de webhook, o Avantto fornecerá uma URL única. É essencial copiar essa URL, pois ela será usada pela plataforma externa para enviar dados.

Etapa 4: Configurando a Plataforma Externa para Enviar Dados

1. Configure uma requisição POST : Na plataforma externa, defina uma requisição POST para a URL do webhook copiada na etapa anterior.

2. Envie dados em formato JSON : Os dados devem ser enviados no formato JSON. Por exemplo:

1. {

2. "nome": "Igor",

3. "email": "igor@avanttocrm.com",

4. "phone": "98987654321"

5. }

3. Assegure-se de incluir os cabeçalhos corretos : Dependendo da configuração do Avantto, pode ser necessário incluir cabeçalhos como "Content-Type: application/json".

4. Salve o Mapeamento de Referência e confirme se os dados estão chegando corretamente

Etapa 5: Mapeando Dados no Workflow do Avantto

1. Adicione uma ação para criar ou atualizar um contato : Após o trigger do webhook, adicione uma ação para criar ou atualizar um contato no Avantto.

1. Mapeie os dados de entrada para os campos do contato : Utilize a opção de mapeamento de referência para vincular os dados recebidos via webhook aos campos correspondentes do contato. Por exemplo:

   • Full Name : Mapeie para {{inboundWebhookRequest.nome}}

   • Email : Mapeie para {{inboundWebhookRequest.email}}

   • Phone : Mapeie para {{inboundWebhookRequest.phone}}

Etapa 6: Testando a Integração

1. Envie uma requisição de teste da plataforma externa : Utilize uma ferramenta como Postman ou o recurso de teste da própria plataforma externa para enviar dados de teste para o webhook.

2. Verifique se o contato foi criado ou atualizado no Avantto : Após receber a requisição, o Avantto deve criar ou atualizar o contato com base nos dados fornecidos.

Considerações Finais

• Formatação dos Dados : Certifique-se de que os dados enviados estejam no formato JSON correto e que todos os campos necessários sejam incluídos.

• Autenticação e Segurança : Não é necessário implementar mecanismos de autenticação ou validação de dados.

Completando essas etapas, você deverá ter uma integração funcional via webhook entre a plataforma externa e o Avantto, permitindo a sincronização de dados de forma eficiente e a possibilidade de utilizar todas as funcionalidades das automações da Avantto.