Configurando RD Marketing

Diferente das demais integrações nativas, onde precisamos obrigatoriamente passar o token de acesso para usá-la, a integração com RD Marketing necessita de um Aplicativo do RD Marketing Store. Antes de utilizar esta integração, por favor entre em contato com o suporte da Suri e solicite a implantação desta etapa, que é super rápida e não tem nenhum custo adicional. Uma vez conectada a conta RD ao aplicativo Suri, todas as ações aqui descritas funcionarão corretamente, caso contrário, você irá obter um erro de permissão e a ação desejada (por exemplo, criar um lead) não será realizada, mas não quebrará o fluxo conversacional, que irá seguir corretamente.

A ação de integração com RD Marketing é adicionada utilizando o botão "Integrações", selecionando a sub-opção "RD Marketing".

Com isso, a ação será inserida no fluxo. Você verá que tem duas opções de "Eventos", que representam ações a serem realizadas dentro do RD Marketing. Abstraindo ao conceito de API, cada evento seria uma chamada a um endpoint diferente da API do RD. As ações suportadas atualmente são:

• Criar/atualizar contato: cria um novo contato ou atualiza um contato existente no RD Marketing utilizando o e-mail como identificador

• Adicionar tag: adiciona uma tag a um contato existente no RD utilizando o e-mail como identificador

Começamos pelo evento mais simples: adicionar tag: durante o fluxo de conversa com a Suri, uma ou mais tags são adicionadas ao contato do RD Marketing.

Esse evento é útil para quando temos a garantia que o contato existe no RD e queremos apenas adicionar uma nova TAG, sem alterar as existentes dele. Ou seja, essa adição de tag é apenas um "append" de tag. Neste evento temos dois campos obrigatórios: email e tags, onde o primeiro é o campo utilizado como identificador do contato no RD e o segundo as tags que desejamos adicionar ao contato separadas por quebra de linha (enter). Note que podemos utilizar macros do contato nos dois campos, aproveitando assim os campos já existentes, como Email ou variáveis customizadas que você capturou durante o fluxo.

Já sobre o evento de criar/atualizar contato, também usamos o email (que pode ser variável usando macros) como identificador, se já existir um contato no RD com o e-mail informado, iremos atualizar somente os campos passados, caso não exista, um contato será criado e somente os campos informados serão preenchidos. Podemos passar todos os campos possíveis no RD, como nome, telefone, cargo e o melhor: todos os campos customizados.

Note que, como essa integração é feita via API, os nomes dos campos da API devem ser informados corretamente no formato aceito pela API da RD. Por exemplo, o campo que aparece como "Cargo" no RD na verdade se chama "job_title". Segue abaixo a lista completa das possibilidades de campos padrão do RD que são suportados na Suri:

{
  name: string, // Ex: Victor de Almeida
  email: string, // Ex: [e-mail]
  job_title: string, // Ex: Desenvolvedor
  birthdate: string, // Ex: 1997-11-14
  bio: string, // Ex: Desenvolvedor na Suri
  website: string, // Ex: https://suri.ai
  personal_phone: string, // Ex: [phone]
  mobile_phone: string, // Ex: [phone]
  city: string, // Ex: Fortaleza
  state: string, // Ex: CE
  country: string, // Ex: Brasil
  twitter: string, // EX: https://twitter.com/XXXX
  facebook: string, // EX: https://facebook.com/XXXX
  linkedin: string, // EX: https://linkedin.com/XXXX
  tags: string[] // EX: [ "tag1", "tag2" ] -> no front, devem ser separadas por quebra de linha
}

Os campos customizados também respeitam a mesma regra de nomes da API. Você pode encontrar o nome correto na própria tela de criação de campos personalizados no RD, como mostrado abaixo

Segue abaixo um exemplo completo mostrando o uso de um campo padrão (telefone) e um campo customizado: