👩‍💻
Manual de Integração
  • 🏠Início
  • 🔗Webhooks
    • Habilitando
    • Tipos de webhook
  • 🌐API
    • Autenticacão
    • Utilizacão
  • 💬Flow
    • Gatilhos
      • Frases de treino (PLN)
      • Anúncios da META
      • Webhooks
        • RD Marketing
        • Customizado
    • Integrações nativas
      • Configurando RD CRM
      • Configurando Pipedrive
      • Configurando Nectar CRM
      • Configurando RD Marketing
    • Captura de dados
    • Variáveis de contato
    • Validação e formatação de captura
    • Utilizando dados do contato
    • Requisição HTTP
      • Retorno vinculado à Suri
      • Retorno livre
      • Retorno de lista
    • Múltiplas etapas
  • 🧠Intenção de IA (legado)
    • Resumão
    • Exemplo de uso 1: segunda via
    • Fluxo Suri vs. Fluxo Externo
    • Exemplo de uso 2: formulário
  • ❓FAQ
Powered by GitBook
On this page
  1. Flow
  2. Integrações nativas

Configurando RD Marketing

PreviousConfigurando Nectar CRMNextCaptura de dados

Last updated 2 months ago

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 . Antes de utilizar esta integração, por favor entre em contato com o 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.

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: victor@email.com
  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: +55 85 9 8877-6655
  mobile_phone: string, // Ex: +55 85 9 8877-6655
  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:

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 nos dois campos, aproveitando assim os campos já existentes, como Email ou variáveis customizadas que você capturou durante o fluxo.

💬
utilizar macros do contato
Aplicativo do RD Marketing Store
suporte da Suri