Todas as coleções
Integrações
Integrações (Saída de Dados Webhoocks)
Integrações (Saída de Dados Webhoocks)

Defina as regras de integração, para automatizar o fluxo de informação, tanto para entrada de dados quanto para saída via Webhook.

Thiago Pirinelli avatar
Escrito por Thiago Pirinelli
Atualizado há mais de uma semana

Recursos de Integrações do Funil de Vendas

Este recurso serve para integrar seus formulários de contato de Sites, Landing Pages, Squeeze Pages, etc, no Funil de Vendas™, automatizando o processo de cadastros. É possível integrar também com outros CRM’s como entrada de dados ou saída via Webhooks.

Importante: Recomendamos que utilize o serviço de um profissional para integrar sua aplicação ao Funil de Vendas.

Webhook Saída de Dados

Para a saída de dados do Funil de Vendas, crie o Webhook desejado e siga a documentação à baixo.

Webhook é uma ferramenta útil para aplicativos que desejam executar algum código após um evento específico acontecer, por exemplo, uma oportunidade ser cadastrada ou ter um novo produto inserido.

Ao invés de preparar seu aplicativo para listar os dados em uma API a cada X número de minutos para verificar se o evento ocorreu, você pode registrar webhooks, que enviam requisições HTTP para sua aplicação levando as informações do evento.

Webhooks são configurados para o aplicativo ao qual estão registrados. Isso significa que quando um webhook é registrado em um aplicativo, outros aplicativos não podem visualizá-lo, modificá-lo ou excluí-lo.

Lista de eventos do Funil de Vendas que suportam Webhooks

Criação de oportunidades

POST /opportunity

Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==

Content-Type: application/json

{ OPPORTUNITY }

 

Edição de oportunidades

PUT /opportunity/CODE_OPPORTUNITY

Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==

Content-Type: application/json

{ OPPORTUNITY }

 

Exclusão de oportunidades

DELETE /opportunity/CODE_OPPORTUNITY

Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==

Ganhar oportunidade

POST /opportunity/win/CODE_OPPORTUNITY

Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==

 

Perder oportunidade

POST /opportunity/lose/ CODE_OPPORTUNITY

Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==

Lista de objetos

Objeto Opportunitty

Objeto Contact

Objeto Company

Objeto Vendedor

Objeto Pipeline

Objeto PipelineStep

Objeto SalesChannel

Objeto Product

Enumerador OpportunittyStatus

Códigos dos status de retornos

2xx – Sucesso

4xx – Erros do cliente

5xx – Erros do servidor

Cadastrar seus Webhook

Para informar seus webhooks, no Funil de Vendas, acesse a opção Configuração > Integrações e na aba Webhooks crie um novo webhook.

Ao criar um novo webhook é necessário informar o nome, a URL, o usuário, a senha e os eventos que deseja que o Funil de Vendas comunique o seu sistema.

Autenticação

O Funil de Vendas chamará seus webhooks passando um token do tipo Basic gerado a partir do usuário e senha informado no cadastro do webhook. Esse token é enviado no cabeçalho das requisições na propriedade “Authorization”. Ex:

POST / opportunity HTTP/1.1

Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==

Content-Type: application/json

 

* O token do tipo basic é um Base64 criado a partir de um login e uma senha.

 

Ambientes

Sandbox

Disponível 45 dias para testes

 

Produção

Isto respondeu à sua pergunta?