Configurações

API

Como enviar um contato do Dinamize Automation para outro sistema próprio via URL - Webhook

Ao criar um fluxo de automação umas das opções disponibilizadas é enviar os dados de um lead ou cliente à outro sistema através do gatilho de webhook. Dessa forma, é possível criar uma página para receber esses dados e encaminhar para outro serviço desejado. 


Para sistemas CRM Pipedrive e Piperun já possuímos integração direta, não necessitando criar uma página para essas plataformas. 

Veja como enviar informações do Dinamize Automation para seu PipeDrive através do Webhook

Veja como enviar dados do Dinamize Automation para o PipeRun



Para iniciar a integração primeiramente você precisa possuir uma página que esteja pronta para receber dados enviados pelo nosso sistema. 


Todas as contas de nossa plataforma possuem alguns campos padrões que serão enviados em todas as requisições em formato JSON: 



"fixed_fields": {
"cmp1": "aqui_o_email_do_lead@teste.com.br",
"cmp2": "Aqui vai o Nome do lead",
"cmp3": "Aqui é o código externo do lead",
"cmp4": [" Aqui são valores de marcadores/tags 1", "Aqui são valores de marcadores/tags 2"],
"current_score": "0",                                     //Aqui o score atual do lead
"insert_date": "2018-10-11 12:54:29",       //aqui a data e horário da inserção
"list_code": "1",                                           //aqui é o código da lista do lead
"stage": "1",                                              //Aqui é o estágio do Lead: 1 - Contatos 2 - Oportunidades 3 - Clientes
"total_score": "0"                                      //Aqui o score acumulado do lead
}




Com uma URL preparada para receber esses dados e repassar para o seu sistema próprio, acesse sua conta Dinamize Automation, vá em Configurações de Empresa e então Sistemas de Terceiros




Clique em Adicionar Sistema de Terceiro



Localize a opção JSON -> URL, então cadastre a URL criada no passo anterior, dê um nome para sua integração e se desejar, informe parâmetros fixos a serem enviados. 



Pronto, agora nos fluxos de automação, você poderá selecionar qualquer ação desejada e enviar os dados para seu sistema próprio 



Por exemplo, caso queira enviar os contatos que preencheram um formulário de uma Landing Page, basta seguir esses passos: 





Selecione então a opção Enviar Webhook 



Selecione então a URL já previamente cadastrada, ou então cadastre-a nesse passo. 


E pronto, automaticamente quando alguém converter em sua landing page, será enviado para a página criada. 


Caso sua conta possua outros campos personalizados, como Cidade, Aniversário, etc  também serão enviados esses campos na sua integração. 


Veja abaixo um exemplo de como chegará o JSON de uma conta com campos personalizados de diferentes tipos, como Data e Hora, Telefone, etc. 



{
"custom_fields": {

 //Exemplo de campo do tipo Data e Hora

"cmp10": {
"Name": "data hora",
"Value": "1993-01-25 07:45:01",
"Type": "DH"
},

//Exemplo de campo do tipo Telefone


"cmp11": {
"Name": "telefone",
"Value": "5551999999999",
"Type": "PHN"
},

//Exemplo de campo do tipo Lista de valores únicos


"cmp12": {
"Name": "estado",
"Value": "lvu",
"Type": "LVU"
},

//Exemplo de campo do tipo Lista de valores múltiplos


"cmp13": {
"Name": "lvm",
"Value": [
"lvm1",
"lvm2",
"lvm3"
],
"Type": "LVM"
},

 //campo do tipo Aplicativo

"cmp15": {
"Name": "app",
"Value": "2|514651561651651561",
"Type": "DVC"
},


//campo do tipo Texto Simples (até 80 caracteres)

"cmp5": {
"Name": "texto simples",
"Value": "Texto simples",
"Type": "VC"
},

//campo do tipo Texto Múltiplas linhas


"cmp6": {
"Name": "texto multiplas linhas",
"Value": "texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas texto multiplas linhas ",
"Type": "TXT"
},

//campo do tipo Numérico

"cmp7": {
"Name": "numerico",
"Value": "123",
"Type": "INT"
},

//campo do tipo Decimal

"cmp8": {
"Name": "decimal",
"Value": "123.54",
"Type": "FLT"
},

"cmp9": {
"Name": "data",
"Value": "1993-01-25",
"Type": "DT"
}
},
"extra_fields": {
"parametro": "extra",
"parametro2": "extra2"
},
"fixed_fields": {
"cmp1": "aqui_o_email_do_lead@teste.com.br",
"cmp2": "Aqui vai o Nome do lead",
"cmp3": "Aqui é o código externo do lead",
"cmp4": [
" Aqui são valores de marcadores/tags 1",
"Aqui são valores de marcadores/tags 2"
],
"current_score": "0", //Aqui o score atual do lead
"insert_date": "2018-10-11 12:54:29", //aqui a data e horário da inserção
"list_code": "142", //aqui é o código da lista do lead
"stage": "1", //Aqui é o estágio do Lead: 1 - Contatos 2 - Oportunidades 3 - Clientes
"total_score": "0" //Aqui o score acumulado do lead
}
}




Explicação dos type de cada campo.

LVM - Lista de Valores Múltiplos
LVU - Lista de Valores Únicos
DH - Data/hora
DT - Data
VC - Texto Simples
TXT - Texto Multiplas linhas
INT - Inteiro
FLT - Decimal
PHN - Telefone
DVC - Aplicativo.

Saiba mais sobre os tipos de campos da lista