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
Host: www.suaaplicacao.com.br
Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==
Content-Type: application/json
{ OPPORTUNITY }
Edição de oportunidades
PUT /opportunity/CODE_OPPORTUNITY
Host: www.suaaplicacao.com.br
Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==
Content-Type: application/json
{ OPPORTUNITY }
Exclusão de oportunidades
DELETE /opportunity/CODE_OPPORTUNITY
Host: www.suaaplicacao.com.br
Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==
Ganhar oportunidade
POST /opportunity/win/CODE_OPPORTUNITY
Host: www.suaaplicacao.com.br
Authorization: Basic MzY0RkI0REUtNEE5RC00MjQ5LTgyM0YtOTE0NTY0MjIxRkI4OjEyMzQ1Ng==
Perder oportunidade
POST /opportunity/lose/ CODE_OPPORTUNITY
Host: www.suaaplicacao.com.br
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
Host: www.suaaplicacao.com.br
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