Com o Tag Center integrado ao seu RD Marketing, é possível realizar ações automaticamente a partir de chatBots e/ou eventos ocorridos dentro do Tag Center.
As funções RD_MKT() apresentadas a seguir servem tanto para Scripts de ChatBots quanto para Nodes e Triggers, e recebem sempre 3 parâmetros:
RD_MKT('id_do_canal', 'evento' { 'corpo da requisição' });
Para encontrar o ID do Canal selecionado acesse o painel de administração do seu projeto (https://admin.tagcenter.io) e navegue até CANAIS, caso haja alguma integração ativa com o RD Marketing ela será identificada com o logo do RD e o nome escolhido no momento de sua criação.
Selecione a conexão desejada, o ID será visível após o nome da conexão, conforme imagem a seguir:
O eventos são as ações específicas a serem realizadas no RD e serão listadas a seguir neste artigo.
O corpo da requisição carrega as informações necessárias para a realização da função, como identificadores, dados ou objetos em geral, sempre respeitando o padrão de escrita de arquivos JSON.
Veja a seguir a lista de eventos disponíveis no via Tag Script
A criação de novos leads no RD MKT a partir de scripts é possível com o evento "create_lead".
RD_MKT("channel-id", "create_lead", {
"conversion_identifier": "Name of the conversion event",
"name": "Nome",
"email": "email@email.com",
"job_title": "job title value",
"state": "state of the contact",
"city": "city of the contact",
"country": "country of the contact",
"personal_phone": "phone of the contact",
"mobile_phone": "mobile_phone of the contact",
"twitter": "twitter handler of the contact",
"facebook": "facebook name of the contact",
"linkedin": "linkedin user name of the contact",
"website": "website of the contact",
"cf_custom_field_api_identifier": "custom field value",
"company_name": "company name",
"company_site": "company website",
"company_address": "company address",
"client_tracking_id": "lead tracking client_id",
"traffic_source": "Google",
"traffic_medium": "cpc",
"traffic_campaign": "easter-50-off",
"traffic_value": "easter eggs",
"tags": ["mql", "2019"],
"available_for_mailing": true,
"legal_bases": [
{
"category": "communications",
"type": "consent",
"status": "granted"
}
]
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
A alteração de leads existentes no RD MKT a partir de scripts é possível com o evento "update_lead".
OBS.: Todos os campos disponíveis na criação de lead listada acima também são acessíveis na atualização do mesmo. Caso alguma chave não seja enviada, não haverá alteração da mesma durante a atualização.
RD_MKT("channel-id", "update_lead", {
"name": "Nome",
"email": "email@email.com",
"job_title": "job title value",
"state": "state of the contact",
"city": "city of the contact",
"country": "country of the contact",
"personal_phone": "phone of the contact",
"mobile_phone": "mobile_phone of the contact",
"website": "website of the contact",
"cf_custom_field_api_identifier": "custom field value",
"tags": ["mql", "2019"],
"legal_bases": [
{
"category": "communications",
"type": "consent",
"status": "granted"
}
]
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
A criação de tags nos leads existentes no RD MKT a partir de scripts é possível com o evento "create_tag".
RD_MKT("channel-id", "create_tag", {
"email": "email@lead.com.br",
"tags": ["tag_tag"]
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
A busca por leads existentes no RD MKT a partir de scripts é possível com o evento "get_lead".
RD_MKT("channel-id", "get_lead", {
"email": "email@email.com"
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Marcar novas oportunidades em leads existentes no RD MKT a partir de scripts é possível com o evento "mark_opportunity".
RD_MKT("channel-id", "mark_opportunity", {
"email": "email@email.com",
"funnel_name": "default"
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Marcar o ganho de oportunidades RD MKT a partir de scripts é possível com o evento "opportunity_won".
RD_MKT("channel-id", "opportunity_won", {
"email": "email@email.com",
"funnel_name": "default",
"value": 200.0
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Marcar a perda de oportunidades RD MKT a partir de scripts é possível com o evento "opportunity_lost".
RD_MKT("channel-id", "opportunity_lost", {
"email": "email@email.com",
"funnel_name": "default",
"reason": "Lead não tinha dinheiro"
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Criar conversões no RD MKT a partir de scripts é possível com o evento "conversion".
RD_MKT("channel-id", "conversion", {
"conversion_identifier": "Name of the conversion event",
"name": "Nome",
"email": "email@email.com",
"job_title": "job title value",
"state": "state of the contact",
"city": "city of the contact",
"country": "country of the contact",
"personal_phone": "phone of the contact",
"mobile_phone": "mobile_phone of the contact",
"twitter": "twitter handler of the contact",
"facebook": "facebook name of the contact",
"linkedin": "linkedin user name of the contact",
"website": "website of the contact",
"cf_custom_field_api_identifier": "custom field value",
"company_name": "company name",
"company_site": "company website",
"company_address": "company address",
"client_tracking_id": "lead tracking client_id",
"traffic_source": "Google",
"traffic_medium": "cpc",
"traffic_campaign": "easter-50-off",
"traffic_value": "easter eggs",
"tags": ["mql", "2019"],
"available_for_mailing": true,
"legal_bases": [
{
"category": "communications",
"type": "consent",
"status": "granted"
}
]
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Criar atividades de chat no RD MKT a partir de scripts é possível com o evento "start_chat".
RD_MKT("channel-id", "start_chat", {
"email": "email@email.com",
"chat_subject": "Conversando sobre tecnologia",
"cf_chat_status": "online"
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Finalizar atividades de chat no RD MKT a partir de scripts é possível com o evento "end_chat".
RD_MKT("channel-id", "end_chat", {
"email": "email@email.com",
"chat_subject": "Conversando sobre tecnologia",
"cf_chat_status": "offline",
"cf_chat_transcript_message": "mensagens transcritas"
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Finalizar atividades de chat no RD MKT a partir de scripts é possível com o evento "end_call".
RD_MKT("channel-id", "end_call", {
"email": "email@email.com",
"call_from_number": "5517912345678",
"call_status": "finished"
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Criar campos personalizados no RD MKT a partir de scripts é possível com o evento "create_field".
RD_MKT("channel-id", "create_field", {
"name": {"pt-BR": "campo_teste1"},
"label": {"pt-BR": "label_teste1"},
"api_identifier": "cf_teste1",
"data_type": "STRING",
"presentation_type": "TEXT_INPUT"
});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
Pegar a lista campos personalizados no RD MKT a partir de scripts é possível com o evento "get_fields".
RD_MKT("channel-id", "get_fields", {});
O retorno desta função pode ser encontrado dentro do objeto "data?.RD_MKT" conforme a imagem a seguir:
