Introdução
A integração entre RD Station e BotConversa pode transformar completamente a maneira como uma empresa captura, atende, qualifica e acompanha seus leads.
Isso acontece porque, enquanto o BotConversa pode atuar diretamente na comunicação e automação das conversas, o RD Station pode centralizar informações comerciais e de marketing. Dessa forma, quando as duas plataformas trabalham de maneira integrada, os dados deixam de ficar isolados.
Além disso, a utilização de APIs permite criar uma comunicação automatizada entre sistemas. Como resultado, informações coletadas durante uma conversa podem ser encaminhadas para o CRM, enquanto dados comerciais podem alimentar novos fluxos de atendimento.
Entretanto, para que essa integração realmente funcione, não basta simplesmente conectar duas ferramentas.
É necessário definir quais dados serão enviados, quando serão enviados, qual sistema será responsável por cada informação, como os usuários serão identificados e o que acontecerá quando uma requisição falhar.
Por isso, neste guia, você aprenderá como configurar API para RD Station e BotConversa, desde o planejamento inicial até a criação de fluxos, autenticação, envio de contatos, tratamento de erros e monitoramento.
Assim, ao final, você terá uma visão muito mais clara de como estruturar uma integração profissional entre chatbot, WhatsApp e CRM.
O que é a integração entre RD Station e BotConversa?
Antes de configurar qualquer API, primeiramente é importante compreender o papel de cada plataforma.
O BotConversa pode ser utilizado para criar automações de comunicação, principalmente em canais de conversa, enquanto o RD Station CRM permite organizar contatos, oportunidades e processos comerciais.
Consequentemente, a integração pode criar um fluxo semelhante a este:
Cliente → BotConversa → Qualificação → API → RD Station CRM → Vendas
Por exemplo, imagine uma empresa que recebe mensagens pelo WhatsApp.
O cliente inicia uma conversa e responde:
“Quero orçamento para uma instalação.”
O chatbot pode identificar a intenção, perguntar nome, telefone, empresa, cidade e tipo de serviço.
Em seguida, esses dados podem ser enviados para o CRM.
Assim, o vendedor recebe uma oportunidade mais estruturada, em vez de precisar copiar manualmente as informações da conversa.
Além disso, a integração pode registrar a origem do lead, criar uma negociação e encaminhar informações adicionais para o processo comercial.
O resultado é uma operação mais organizada, rastreável e escalável.
Por que integrar RD Station e BotConversa?
Existem várias razões para integrar o RD Station ao BotConversa.
Primeiramente, essa integração pode reduzir tarefas manuais e tornar o fluxo comercial mais eficiente.
Sem uma integração, por exemplo, um atendente pode precisar copiar informações do WhatsApp para o CRM. Depois, ele ainda pode precisar atualizar etapas do funil, registrar observações e avisar um vendedor sobre o novo lead.
Com uma API, os sistemas conseguem executar parte dessas tarefas automaticamente. Assim, a equipe reduz o trabalho operacional e consegue dedicar mais tempo ao atendimento e à negociação.
Além disso, a integração permite:
- Centralizar as informações dos leads;
- Automatizar a criação de contatos;
- Criar oportunidades comerciais;
- Qualificar leads antes do atendimento humano;
- Registrar automaticamente as informações coletadas pelo chatbot;
- Reduzir erros de digitação;
- Acelerar o atendimento;
- Melhorar o acompanhamento comercial;
- Criar processos de nutrição;
- Integrar as equipes de marketing e vendas;
- Acompanhar a origem dos leads;
- Automatizar tarefas repetitivas.
Nesse sentido, a API funciona como uma ponte entre diferentes sistemas. O BotConversa pode coletar informações durante a conversa e, posteriormente, o sistema responsável pela integração pode enviar esses dados ao RD Station para alimentar o processo comercial.
Portanto, o objetivo não consiste simplesmente em “conectar duas ferramentas”.
Na prática, a integração busca criar um processo automatizado de aquisição, atendimento, qualificação e conversão, conectando as informações coletadas durante a conversa às etapas seguintes da jornada comercial.
Como funciona uma API?
API significa Application Programming Interface, ou Interface de Programação de Aplicações.
De maneira simples, uma API permite que diferentes sistemas troquem informações seguindo regras previamente estabelecidas.
Imagine, por exemplo, que o BotConversa receba os seguintes dados durante uma conversa:
Nome: João
E-mail: joao@email.com
Telefone: 11999999999
Interesse: Consultoria
Nesse cenário, o sistema pode enviar essas informações para um endpoint da API do RD Station.
O RD Station recebe a requisição, interpreta os dados e processa a operação. Em seguida, a API retorna uma resposta que informa se o sistema concluiu a operação ou encontrou algum problema.
Assim, podemos representar o fluxo básico da seguinte maneira:
BotConversa
↓
Requisição HTTP
↓
API do RD Station
↓
Processamento
↓
Resposta
↓
BotConversa / Sistema intermediário
Entretanto, uma integração profissional normalmente envolve mais etapas.
Por exemplo, o processo pode começar com uma conversa no WhatsApp. Depois, o BotConversa pode realizar a qualificação, validar os dados coletados e enviar as informações por meio de uma API ou webhook.
Nesse caso, o fluxo pode seguir esta estrutura:
WhatsApp
↓
BotConversa
↓
Qualificação
↓
Validação dos dados
↓
API / Webhook
↓
RD Station
↓
Contato
↓
Negociação
↓
Vendedor
Dessa forma, a integração conecta a conversa inicial às etapas seguintes do processo comercial.
Além disso, o fluxo permite transformar os dados coletados pelo chatbot em informações úteis para a equipe de vendas. Como resultado, o negócio consegue organizar melhor os leads, acompanhar as oportunidades e dar continuidade ao atendimento sem depender de processos manuais em cada etapa.
Portanto, a API não apenas conecta sistemas. Ela permite criar uma comunicação estruturada entre diferentes ferramentas e automatizar ações que antes exigiam intervenção manual.
O que você precisa antes de começar?
Antes de configurar a integração, é importante preparar todo o ambiente. Primeiramente, você precisa definir qual produto do RD Station pretende utilizar. Além disso, essa escolha influencia diretamente os recursos, os endpoints e o fluxo que você deverá configurar posteriormente.
Neste artigo, especificamente, o foco principal está no RD Station CRM, porque essa solução permite trabalhar com contatos e negociações por meio da API v2.
Nesse sentido, a documentação oficial informa que a API v2 do RD Station CRM utiliza OAuth 2.0, trabalha com JSON e disponibiliza uma URL base específica para os recursos do CRM.
Além disso, antes de iniciar o desenvolvimento, você deverá organizar os seguintes recursos e informações:
- Conta no RD Station CRM;
- Acesso adequado ao produto;
- Aplicação cadastrada no ecossistema do RD Station;
client_id;client_secret;- URL de callback;
- Estrutura de chatbot no BotConversa;
- Campos que você pretende enviar;
- Endpoint ou sistema intermediário para realizar a integração;
- Estratégia para tratamento de erros.
Do lado do BotConversa, você também precisa considerar os recursos disponíveis para integração. Nesse caso, a documentação pública da API disponibiliza endpoints para recursos como campos, campanhas, fluxos, assinantes, tags e mensagens.
Além disso, a API informa um limite de 600 requisições por minuto. Por isso, durante o desenvolvimento, você deve considerar esse limite ao definir a frequência das requisições e a lógica de comunicação entre os sistemas.
Consequentemente, quanto melhor você organizar essas informações antes de começar, mais fácil será estruturar a integração e identificar possíveis problemas durante a implementação.
Primeiro passo: desenhe o fluxo da integração
Antes de escrever qualquer código, primeiramente, desenhe todo o processo que você pretende automatizar.
Essa etapa parece simples. Entretanto, ela pode evitar diversos problemas posteriormente, principalmente quando o fluxo envolve diferentes sistemas, etapas comerciais e condições de decisão.
Por exemplo, imagine um atendimento iniciado pelo WhatsApp. Nesse primeiro momento, o BotConversa pode conduzir o usuário por uma sequência de perguntas.
Em seguida, o chatbot coleta as informações necessárias. Depois disso, ele identifica a intenção do usuário, realiza a qualificação e encaminha os dados para a próxima etapa.
Um fluxo básico pode seguir esta estrutura:
Cliente inicia conversa
↓
Bot pergunta nome
↓
Bot pergunta telefone
↓
Bot pergunta interesse
↓
Bot identifica intenção
↓
Lead é qualificado
↓
Dados são enviados
↓
RD Station cria ou atualiza o contato
↓
Negociação é criada
↓
Vendedor recebe a oportunidade
Entretanto, o fluxo não termina simplesmente quando o sistema envia os dados para o CRM.
Antes disso, você precisa definir o que acontecerá em diferentes situações. Por exemplo, imagine que o cliente já tenha um cadastro no RD Station.
Nesse caso, criar um segundo contato pode gerar duplicidade e dificultar o acompanhamento comercial. Por isso, a integração precisa consultar ou identificar o contato existente antes de executar determinadas ações.
.
Dessa maneira, você pode estruturar regras como:
- Lead novo → criar contato;
- Lead existente → atualizar ou utilizar o contato existente;
- Lead qualificado → criar negociação;
- Lead desqualificado → encaminhar para nutrição.
Além disso, você pode incluir outras condições conforme a estratégia comercial. Por exemplo, determinados interesses podem direcionar o lead para equipes específicas, enquanto outros podem iniciar fluxos diferentes de relacionamento.
Assim, o chatbot deixa de atuar apenas como uma ferramenta de atendimento e passa a participar de um processo comercial integrado.
Em outras palavras, a API conecta os sistemas, mas a estratégia define o que cada sistema deve fazer em cada etapa.
Portanto, antes de desenvolver a integração, desenhe o fluxo completo, estabeleça as regras de decisão e defina o destino de cada informação.
Dessa forma, a integração deixa de representar apenas uma conexão técnica entre ferramentas e passa a funcionar como uma estrutura organizada de aquisição, atendimento, qualificação, relacionamento e conversão.
Segundo passo: crie seu aplicativo no RD Station
Para utilizar OAuth 2.0 no RD Station CRM, você precisa criar uma aplicação e obter as credenciais correspondentes.
Primeiramente, o processo envolve o cadastro do aplicativo e a configuração de uma URL de callback. Além disso, o próprio RD Station informa que a aplicação recebe um client_id e um client_secret, que você deve armazenar com segurança.
Na prática, você terá informações semelhantes a:
CLIENT_ID=xxxxxxxx
CLIENT_SECRET=xxxxxxxx
REDIRECT_URI=https://seusistema.com/callbackEntretanto, nunca coloque o client_secret diretamente dentro do chatbot ou em qualquer código que possa ficar exposto ao navegador.
Em vez disso, armazene essa credencial no backend ou utilize variáveis de ambiente. Dessa maneira, você mantém as informações sensíveis separadas do código da aplicação e reduz o risco de exposição.
Por exemplo, você pode organizar as variáveis da seguinte forma:
RD_CLIENT_ID=seu_client_id
RD_CLIENT_SECRET=seu_client_secret
RD_REDIRECT_URI=https://seusistema.com/callbackAssim, o código da aplicação pode acessar essas informações por meio do ambiente de execução, sem precisar armazenar diretamente os valores das credenciais.
Além disso, essa organização facilita a manutenção do projeto. Por exemplo, você consegue alterar credenciais ou ambientes de desenvolvimento sem modificar diretamente o código principal da integração.
Portanto, desde o início, trate o client_secret como uma informação confidencial e mantenha essa credencial exclusivamente no lado do servidor.
Terceiro passo: configure a URL de callback
A URL de callback desempenha um papel fundamental no processo de autenticação.
Basicamente, ela indica ao RD Station para onde o sistema deve encaminhar o código de autorização depois que o usuário concluir o processo de autorização da aplicação.
Por exemplo, você pode utilizar uma URL como:
https://seudominio.com.br/rdstation/callbackDepois que o usuário autorizar a aplicação, o RD Station poderá direcionar o navegador para um endereço semelhante a:
https://seudominio.com.br/rdstation/callback?code=ABC123Nesse momento, o backend recebe o parâmetro code e utiliza esse código para solicitar os tokens necessários para continuar a comunicação com a API.
Entretanto, você precisa considerar uma característica importante desse processo: o código de autorização possui validade limitada.
De acordo com a documentação atual do RD Station CRM, o código apresenta validade de apenas cinco minutos.
Por isso, o backend deve realizar a troca do código pelos tokens dentro desse período. Caso contrário, o sistema poderá perder a validade do código e exigir uma nova autorização.
Além disso, a aplicação deve tratar esse processo com cuidado, porque a URL de callback representa uma etapa essencial do fluxo OAuth 2.0.
Dessa maneira, o fluxo básico fica assim:
Usuário autoriza a aplicação
↓
RD Station gera o código de autorização
↓
RD Station direciona para a URL de callback
↓
Backend recebe o code
↓
Backend solicita os tokens
↓
Aplicação utiliza os tokens para acessar a API
Assim, a URL de callback conecta a etapa de autorização ao backend e permite que a aplicação avance para as próximas etapas da integração.
Quarto passo: faça a autenticação OAuth 2.0
A autenticação do RD Station CRM utiliza o padrão OAuth 2.0. Nesse sentido, a aplicação precisa seguir uma sequência específica para obter autorização e, posteriormente, acessar os recursos protegidos da API.
De forma simplificada, o fluxo funciona assim:
Aplicação
↓
Solicita autorização
↓
Usuário autoriza
↓
RD Station retorna o code
↓
Backend troca o code
↓
Aplicação recebe access_token + refresh_token
Primeiramente, a aplicação inicia o processo de autorização. Em seguida, o usuário concede a autorização solicitada. Depois disso, o RD Station retorna um código temporário para a URL de callback configurada anteriormente.
A partir desse momento, o backend utiliza o code para solicitar os tokens de acesso.
O endpoint de autenticação OAuth 2.0 utilizado pelo RD Station é:
https://api.rd.services/oauth2Na etapa seguinte, o backend envia o código de autorização para o endpoint de token.
.
Por exemplo, você pode realizar essa solicitação com cURL:
curl -X POST https://api.rd.services/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=SEU_CLIENT_ID" \
-d "client_secret=SEU_CLIENT_SECRET" \
-d "code=SEU_CODE" \
-d "redirect_uri=https://seudominio.com.br/callback" \
-d "grant_type=authorization_code"Depois que o RD Station processa a requisição, a API retorna os tokens necessários para que a aplicação realize chamadas autenticadas.
Nesse ponto, o access_token permite que o backend acesse os recursos autorizados da API. Além disso, o refresh_token permite renovar o acesso quando o token principal atingir o fim da validade.
Atualmente, o access_token possui validade de duas horas. Por isso, a aplicação precisa implementar uma estratégia de renovação para manter a comunicação funcionando continuamente.
Além disso, o processo de renovação exige atenção ao refresh_token. O RD Station orienta que, quando a aplicação realizar uma renovação, ela armazene o novo refresh_token retornado pela API e descarte o anterior.
Dessa maneira, o backend mantém os tokens atualizados e consegue continuar realizando chamadas autenticadas sem exigir uma nova autorização do usuário a cada expiração do access_token.
Em resumo, o fluxo completo pode seguir esta sequência:
Usuário autoriza
↓
RD Station retorna code
↓
Backend envia code para o endpoint de token
↓
RD Station retorna access_token + refresh_token
↓
Backend utiliza o access_token nas requisições
↓
Token expira
↓
Backend utiliza o refresh_token para renovar o acesso
↓
Backend armazena o novo refresh_token
Assim, o OAuth 2.0 cria uma camada de autorização entre a aplicação e o RD Station CRM, enquanto o backend administra os tokens e mantém a comunicação com a API ao longo do tempo.
Quinto passo: armazene os tokens corretamente
Essa etapa merece atenção especial porque os tokens permitem que a aplicação acesse recursos autorizados da API.
Primeiramente, nunca armazene tokens em locais que possam expor essas credenciais a terceiros.
Por exemplo, evite armazenar essas informações em:
- Código público;
- JavaScript executado no navegador;
- Planilhas abertas;
- Mensagens;
- Repositórios públicos;
- Campos que os usuários conseguem visualizar.
Em contrapartida, utilize estruturas que ofereçam maior controle sobre o acesso às credenciais, como:
Banco de dados seguro
+
Variáveis de ambiente
+
Controle de acesso
Além disso, você pode organizar as credenciais em uma estrutura específica no banco de dados.
Uma estrutura possível seria:
integration_credentials
id
provider
client_id
client_secret
access_token
refresh_token
expires_at
created_at
updated_atNesse caso, o sistema consegue relacionar cada conjunto de credenciais ao respectivo provedor e controlar informações como a data de expiração do token.
Consequentemente, antes de realizar uma nova requisição, o backend pode verificar se o access_token ainda permanece válido.
Caso o token tenha expirado, a aplicação pode iniciar o processo de renovação utilizando o refresh_token, conforme o fluxo de autenticação definido pelo RD Station.
Dessa maneira, o sistema evita chamadas desnecessárias com tokens expirados e consegue manter o processo de autenticação organizado.
Além disso, essa estrutura facilita a manutenção da integração. Por exemplo, caso o sistema trabalhe posteriormente com outros provedores, você pode utilizar a mesma estrutura para armazenar as credenciais de cada integração.
Portanto, o armazenamento correto dos tokens não representa apenas uma questão de organização. Ele também ajuda o backend a controlar o acesso, acompanhar a validade das credenciais e manter a integração funcionando de maneira consistente.
Sexto passo: entenda a API do RD Station CRM
Depois de configurar a autenticação e organizar os tokens, o próximo passo consiste em entender como a API do RD Station CRM recebe e processa as requisições.
A API v2 do RD Station CRM utiliza a seguinte URL base:
https://api.rd.services/crm/v2Além disso, a aplicação utiliza JSON para enviar e receber dados, enquanto o backend precisa incluir as credenciais de autenticação nas requisições que acessam recursos protegidos.
Por exemplo, uma consulta de contatos pode utilizar:
GET https://api.rd.services/crm/v2/contacts
Authorization: Bearer SEU_ACCESS_TOKEN
Content-Type: application/jsonNesse caso, o Authorization informa ao servidor qual token a aplicação utiliza para acessar o recurso.
A partir dessa estrutura, o backend pode consultar e manipular diferentes recursos da API, conforme as permissões, endpoints e operações disponíveis.
Entre os principais recursos, podemos citar:
- Contatos;
- Negociações;
- Empresas;
- Produtos;
- Tarefas;
- Reuniões;
- Campos personalizados.
Além disso, o sistema pode combinar esses recursos para criar fluxos comerciais mais completos.
Por exemplo, o BotConversa pode coletar os dados de um potencial cliente durante uma conversa. Em seguida, o backend pode enviar essas informações ao RD Station CRM para criar ou atualizar um contato.
Depois disso, a aplicação pode utilizar outras operações da API para organizar a oportunidade e alimentar as etapas seguintes do processo comercial.
Assim, o chatbot deixa de atuar apenas como uma ferramenta de atendimento e passa a integrar uma estrutura maior de aquisição, qualificação e gestão de oportunidades.
Em outras palavras, a API permite conectar a conversa iniciada pelo cliente às operações que acontecem posteriormente no CRM.
Dessa forma, BotConversa, backend e RD Station CRM podem trabalhar em conjunto para automatizar diferentes etapas do processo comercial.
Sétimo passo: crie o contato no RD Station
Um dos primeiros fluxos que você provavelmente desejará implementar é:
BotConversa → RD Station → Novo contato
A API do RD Station CRM disponibiliza o endpoint:
POST https://api.rd.services/crm/v2/contacts
A documentação oficial informa que o endpoint pode retornar, entre outros códigos, 201 para criação bem-sucedida, 401 para token ausente ou inválido, 403 para falta de permissão, 422 para entidade não processável e 429 quando o limite de requisições é excedido.
Um exemplo conceitual de payload pode ser:
- {
- “data”: {
- “name”: “João da Silva”,
- “email”: “joao@email.com”,
- “phones”: [
- {
- “phone”: “5511999999999”
- }
- ]
- }
- }
Entretanto, o payload definitivo deve seguir o esquema e os campos aceitos pela versão atual da API.
Por isso, não copie um exemplo genérico para produção sem validar a documentação correspondente ao recurso utilizado.
Oitavo passo: transforme o lead em oportunidade
Criar um contato é apenas uma parte da estratégia.
A verdadeira transformação acontece quando o lead qualificado também pode ser convertido em uma oportunidade comercial.
Nesse caso, você pode criar uma negociação no RD Station.
O endpoint utilizado é:
POST https://api.rd.services/crm/v2/deals
A API permite criar negociações e utilizar stage_id para posicioná-las em uma etapa específica do funil. Além disso, a documentação informa que novas negociações devem ser criadas com status ongoing.
Imagine, por exemplo, que o BotConversa pergunte:
Qual serviço você deseja contratar?
O cliente responde:
Consultoria de marketing.
Depois, o chatbot pergunta:
Qual é o faturamento aproximado da sua empresa?
O cliente responde:
R$ 100 mil por mês.
A partir dessas respostas, o sistema pode classificar o lead como qualificado.
Então:
BotConversa
↓
Lead qualificado
↓
API
↓
Contato no RD Station
↓
Negociação
↓
Etapa comercial
↓
Vendedor
Consequentemente, o vendedor recebe um lead que já passou por uma primeira triagem.
Como enviar dados do BotConversa para o RD Station?
Agora chegamos ao ponto central da integração.
O BotConversa coleta as informações durante a conversa.
Por exemplo:
nome
telefone
empresa
cidade
serviço
orçamento
interesse
origem
Essas informações precisam ser transformadas em uma estrutura compatível com o sistema de destino.
Uma arquitetura comum é:
BotConversa
↓
Webhook/API
↓
Middleware
↓
Validação
↓
RD Station CRM
O middleware é uma camada intermediária que pode receber os dados, validar informações, transformar formatos, verificar duplicidade e realizar as chamadas para o RD Station.
Essa arquitetura é especialmente interessante quando a empresa utiliza várias integrações.
Assim, em vez de conectar:
- BotConversa → RD Station
- BotConversa → ERP
- BotConversa → Financeiro
- BotConversa → BI
você pode criar:
BotConversa
↓
Camada de integração
↓
RD Station
ERP
Financeiro
BI
Como resultado, a manutenção tende a ficar mais organizada.
Webhook ou API: qual utilizar?
Essa dúvida aparece frequentemente.
Embora webhook e API estejam relacionados, eles não representam exatamente a mesma coisa.
A API normalmente permite que um sistema solicite ou envie informações para outro.
Já um webhook pode ser entendido como uma notificação automática disparada quando determinado evento acontece.
Por exemplo:
Evento:
Lead finalizou o chatbot
Webhook:
“Novo lead qualificado”
Sistema:
Recebe o evento
API:
Cria/atualiza contato no RD Station
Portanto, uma integração completa pode utilizar os dois recursos.
Webhook para avisar que algo aconteceu.
API para executar uma ação.
Essa combinação é extremamente poderosa para automações comerciais.
Como estruturar os campos do BotConversa?
Antes de integrar, é recomendável criar um mapa de dados.
Por exemplo:
| BotConversa | RD Station |
| Nome | Nome |
| Telefone | Telefone |
| Empresa | Empresa |
| Serviço | Campo personalizado |
| Cidade | Campo personalizado |
| Origem | Campo personalizado |
| Interesse | Campo personalizado |
| Qualificação | Campo personalizado |
Esse mapeamento evita inconsistências.
Além disso, permite identificar antecipadamente quais informações precisam ser criadas como campos personalizados.
Por exemplo:
interesse_servico
cidade
faixa_faturamento
origem_chatbot
nivel_interesse
produto_interesse
Assim, o CRM passa a armazenar informações muito mais úteis para vendas.
Como evitar contatos duplicados?
Esse é um dos problemas mais importantes de uma integração.
Imagine o seguinte cenário:
Cliente conversa hoje
↓
Contato criado
Cliente conversa amanhã
↓
Novo contato criado
Agora existem dois registros para a mesma pessoa.
Consequentemente, o histórico fica fragmentado.
Para evitar isso, a integração deve ter uma estratégia de identificação.
Por exemplo:
1. Procurar contato por identificador
2. Se existir → atualizar
3. Se não existir → criar
O processo pode ser representado assim:
Lead recebido
↓
Identificar
↓
Existe?
↙ ↘
SIM NÃO
↓ ↓
Atualizar Criar
Dessa maneira, o CRM permanece mais limpo.
Como integrar a qualificação de leads?
Uma das maiores vantagens da integração é utilizar o chatbot para realizar uma pré-qualificação.
Por exemplo:
Pergunta 1:
Qual serviço você procura?
Pergunta 2:
Sua empresa já investe em marketing?
Pergunta 3:
Qual é seu objetivo?
Pergunta 4:
Qual faixa de investimento está disponível?
Com essas respostas, você pode criar uma classificação:
- Lead frio
- Lead morno
- Lead quente
Ou ainda:
- Score 0–30 → Baixa prioridade
- Score 31–70 → Média prioridade
- Score 71–100 → Alta prioridade
Depois, essa informação pode ser enviada ao CRM.
Como resultado, o vendedor pode priorizar os contatos com maior potencial.
Exemplo de fluxo completo
Considere uma agência de marketing digital.
O cliente entra pelo WhatsApp.
O BotConversa pergunta:
Bot: Olá! Como podemos ajudar?
Cliente: Quero anunciar minha empresa no Google.
Bot: Perfeito. Você já investe em Google Ads?
Cliente: Sim.
Bot: Qual é aproximadamente seu investimento mensal?
Cliente: R$ 5.000.
O sistema identifica:
Interesse: Google Ads
Experiência: Já anuncia
Investimento: R$ 5.000
Intenção: Alta
Depois:
BotConversa
↓
Lead qualificado
↓
Webhook
↓
Middleware
↓
Validação
↓
RD Station
↓
Contato
↓
Negociação
↓
Funil “Novos negócios”
↓
Etapa “Lead qualificado”
Finalmente, o vendedor pode receber uma oportunidade com contexto suficiente para iniciar uma abordagem mais relevante.
Como tratar erros da integração?
Uma integração profissional precisa considerar que erros acontecerão.
Por isso, não basta criar apenas o fluxo de sucesso.
Você também precisa planejar:
- Se funcionar → continuar
- Se falhar → registrar erro
- Se token expirar → renovar
- Se limite for atingido → aguardar
- Se dado estiver inválido → corrigir/rejeitar
- Se sistema estiver indisponível → tentar novamente
Entre os códigos importantes da API do RD Station estão:
- 200 — sucesso;
- 201 — recurso criado;
- 400 — requisição inválida;
- 401 — autenticação inválida;
- 403 — ausência de permissão;
- 404 — recurso não encontrado;
- 422 — entidade não processável;
- 429 — limite de requisições excedido;
- 500 — erro interno.
A documentação atual do RD Station CRM confirma esses códigos para operações de recursos como contatos e negociações.
O que fazer quando ocorrer erro 401?
O erro 401 normalmente está relacionado à autenticação.
Nesse caso, verifique:
- Token expirado;
- Token incorreto;
- Header ausente;
- Credenciais inválidas;
- Processo de OAuth interrompido.
Como o access_token do RD Station CRM possui validade de duas horas, o sistema precisa implementar renovação automática.
Portanto, uma arquitetura adequada pode verificar:
Token válido?
↓
SIM → realizar requisição
↓
NÃO → renovar token
↓
Salvar novo token
↓
Realizar requisição
O que fazer quando ocorrer erro 429?
O erro 429 Too Many Requests indica que o limite de requisições foi excedido.
A API v2 do RD Station CRM informa atualmente um limite de até 120 requisições por minuto para os planos Basic, Pro e Advanced, conforme a documentação geral do CRM.
Por isso, sua aplicação precisa controlar o volume de chamadas.
Em vez de:
100 leads
↓
100 requisições simultâneas
pode ser melhor utilizar:
Fila
↓
Processamento controlado
↓
Retry
↓
Confirmação
Além disso, a API fornece informações relacionadas ao tempo de espera quando o limite é excedido.
Assim, o sistema pode implementar uma estratégia de retry com backoff.
Como configurar a integração do lado do BotConversa?
No BotConversa, a integração pode envolver recursos de API, campos, fluxos e assinantes.
A documentação pública atual disponibiliza endpoints relacionados a campos, campanhas, fluxos, assinantes, tags e mensagens, além de indicar uma base de API e limite de chamadas.
Na prática, o fluxo pode ser estruturado assim:
Fluxo do chatbot
↓
Coleta dados
↓
Salva campos
↓
Identifica condição
↓
Dispara integração
↓
Envia dados
↓
Recebe resposta
↓
Continua conversa
Por exemplo, você pode configurar o chatbot para enviar o lead ao sistema somente depois que determinadas informações forem preenchidas.
Isso evita criar contatos incompletos.
API direta ou middleware?
Essa decisão depende da complexidade da operação.
Para uma integração pequena:
BotConversa → API → RD Station
pode ser suficiente.
Entretanto, para uma operação maior:
BotConversa
↓
Middleware
↓
RD Station
↓
ERP
↓
Banco de dados
↓
BI
é mais interessante utilizar uma camada intermediária.
Isso porque o middleware pode centralizar:
- Autenticação;
- Logs;
- Retry;
- Validação;
- Transformação;
- Deduplicação;
- Filas;
- Monitoramento;
- Tratamento de erros.
Consequentemente, a manutenção se torna mais previsível.
Como proteger a integração?
Segurança deve ser considerada desde o início.
Primeiramente, utilize HTTPS.
Além disso:
- Não exponha client_secret;
- Não deixe tokens no frontend;
- Restrinja acessos;
- Registre logs sem expor credenciais;
- Faça rotação quando necessário;
- Valide os dados recebidos;
- Controle permissões;
- Evite armazenar dados desnecessários.
Do mesmo modo, a LGPD precisa ser considerada.
A própria documentação do RD Station CRM destaca a necessidade de observar bases legais para operações envolvendo dados pessoais.
Portanto, não basta perguntar:
“A integração funciona?”
Também é necessário perguntar:
“A integração funciona de maneira segura e adequada?”
LGPD na integração entre chatbot e CRM
O BotConversa pode coletar informações pessoais durante uma conversa.
Entre elas:
- Nome;
- Telefone;
- E-mail;
- Empresa;
- Localização;
- Preferências;
- Informações comerciais.
Consequentemente, a empresa precisa avaliar como esses dados são coletados, utilizados, armazenados e compartilhados.
Por isso:
- Colete apenas o necessário;
- Informe o usuário quando apropriado;
- Defina a finalidade;
- Proteja as informações;
- Controle acessos;
- Evite armazenamento desnecessário;
- Estabeleça políticas de retenção.
Assim, a integração deixa de ser apenas uma questão de tecnologia e passa a fazer parte da governança de dados da empresa.
Como testar a integração?
Nunca coloque uma integração diretamente em produção sem testes.
Primeiramente, teste o cenário básico:
Novo lead
↓
Chatbot
↓
API
↓
Contato criado
Depois, teste:
Lead existente
Lead sem e-mail
E lead sem telefone
Dados inválidos
Token expirado
API indisponível
429
500
Webhook duplicado
Além disso, teste o que acontece quando o usuário interrompe a conversa.
Por exemplo:
Nome preenchido
Telefone preenchido
E-mail vazio
Nesse caso, o sistema deve saber se:
- Não envia;
- Envia parcialmente;
- Solicita o dado novamente;
- Armazena temporariamente.
Quanto mais cenários forem testados, menor será a chance de problemas em produção.
Como monitorar a integração?
Depois que tudo estiver funcionando, o trabalho não termina.
É necessário acompanhar a operação.
Entre os indicadores importantes estão:
- Quantidade de leads enviados;
- Quantidade de contatos criados;
- Quantidade de negociações criadas;
- Taxa de erro;
- Tempo médio de processamento;
- Leads duplicados;
- Erros de autenticação;
- Erros 429;
- Leads qualificados;
- Taxa de conversão.
Além disso, mantenha logs.
Um log útil poderia registrar:
Data/hora
ID da requisição
Tipo de operação
Origem
Destino
Status
Tempo de resposta
Código HTTP
Mensagem de erro
Entretanto, evite registrar tokens e informações sensíveis sem necessidade.
Como transformar a integração em uma máquina de vendas?
A integração pode ir muito além de simplesmente criar contatos.
Imagine o seguinte fluxo:
Anúncio
↓
↓
BotConversa
↓
Qualificação
↓
RD Station
↓
Lead Scoring
↓
Vendedor
↓
Negociação
↓
Follow-up
↓
Venda
Agora acrescente automação.
Se o lead não responder:
Lead parado
↓
Automação
↓
Nova abordagem
Se o lead demonstrar interesse:
Interesse identificado
↓
Prioridade elevada
↓
Vendedor notificado
Se o lead comprar:
Venda
↓
Atualização CRM
↓
Pós-venda
↓
Fidelização
Nesse sentido, a integração passa a conectar marketing, atendimento e vendas em um único processo.
10 erros comuns ao integrar RD Station e BotConversa
1. Começar sem definir o fluxo
Antes de configurar API, defina o processo.
2. Não mapear os campos
Sem mapeamento, os dados podem chegar incompletos.
3. Criar contatos duplicados
Sempre pense na identificação dos leads.
4. Expor credenciais
Nunca coloque tokens e secrets em locais públicos.
5. Ignorar expiração do token
OAuth exige gerenciamento adequado dos tokens.
6. Não tratar erro 429
A integração precisa respeitar limites de requisição.
7. Não criar logs
Sem logs, encontrar problemas se torna muito mais difícil.
8. Não testar cenários de falha
Teste erros, não apenas o caminho feliz.
9. Automatizar sem estratégia comercial
Tecnologia sem processo não garante resultado.
10. Enviar dados demais
Quanto mais dados forem compartilhados sem necessidade, maior pode ser a complexidade e o risco.
Checklist para configurar a integração
Antes de colocar o projeto em produção, confira:
RD Station
- Conta configurada;
- Aplicação criada;
- client_id disponível;
- client_secret protegido;
- Callback configurado;
- OAuth implementado;
- Refresh token implementado;
- Endpoints definidos.
BotConversa
- Fluxo criado;
- Campos configurados;
- Dados obrigatórios definidos;
- Gatilho de integração definido;
- Webhook/API configurado;
- Respostas de erro planejadas.
Integração
- Mapeamento de campos;
- Deduplicação;
- Validação;
- Logs;
- Retry;
- Controle de rate limit;
- Segurança;
- LGPD;
- Monitoramento.
Comercial
- Critérios de qualificação;
- Funil;
- Etapas;
- Responsável;
- SLA;
- Follow-up;
- Indicadores.
Quanto custa integrar RD Station e BotConversa?
O custo depende principalmente da complexidade do projeto.
Uma integração simples pode envolver:
Chatbot
+
Webhook
+
API
+
Criação de contato
Já uma integração mais avançada pode envolver:
Chatbot
+
CRM
+
ERP
+
Banco de dados
+
BI
+
Automação
+
IA
+
Webhooks
+
Filas
+
Monitoramento
Consequentemente, não existe um preço único.
Além disso, devem ser considerados os custos das próprias plataformas, infraestrutura, desenvolvimento, manutenção e eventuais ferramentas intermediárias.
Por isso, o ideal é avaliar a integração como um projeto de negócio, e não simplesmente como uma configuração técnica.
Vale a pena integrar RD Station e BotConversa?
Sim, principalmente quando a empresa possui um volume relevante de leads e precisa reduzir atividades manuais.
Entretanto, o maior benefício não está apenas na automação.
O verdadeiro ganho está na conexão entre dados, atendimento e vendas.
Com a integração correta, o chatbot pode:
- Capturar;
- Qualificar;
- Identificar;
- Organizar;
- Encaminhar;
- Atualizar;
- Automatizar.
Enquanto isso, o CRM pode:
- Centralizar;
- Acompanhar;
- Distribuir;
- Gerenciar;
- Mensurar.
Como resultado, a empresa passa a trabalhar com um processo muito mais integrado.
RD Station + BotConversa + IA
Além da integração tradicional, existe ainda uma possibilidade bastante interessante: adicionar inteligência artificial ao processo.
Imagine:
Cliente
↓
Chatbot com IA
↓
Entendimento da intenção
↓
Qualificação
↓
Extração de dados
↓
CRM
↓
Lead Scoring
↓
Vendas
Nesse cenário, a IA pode ajudar a interpretar mensagens mais complexas.
Por exemplo:
“Eu tenho uma empresa pequena, já anuncio no Instagram, mas estou pensando em começar Google Ads e quero saber quanto preciso investir.”
Em vez de procurar apenas palavras-chave, um agente inteligente pode interpretar a intenção da mensagem.
Assim, a integração entre IA + BotConversa + RD Station pode criar uma operação comercial muito mais sofisticada.
Como uma agência pode ajudar nessa integração?
Embora algumas integrações possam ser configuradas internamente, projetos mais complexos exigem planejamento técnico e estratégico.
Uma agência especializada pode ajudar a:
- Mapear processos;
- Definir arquitetura;
- Configurar APIs;
- Criar automações;
- Integrar CRM;
- Estruturar chatbot;
- Criar fluxos de qualificação;
- Desenvolver middleware;
- Implementar IA;
- Criar dashboards;
- Monitorar indicadores;
- Otimizar conversões.
Nesse sentido, a tecnologia deixa de ser uma ferramenta isolada e passa a fazer parte de uma estratégia completa de marketing e vendas.
A Content Marketing Brasil pode atuar justamente nessa integração entre estratégia, marketing digital, automação, CRM, IA e geração de resultados.
Perguntas frequentes sobre RD Station e BotConversa
É possível integrar RD Station e BotConversa por API?
Sim. A integração pode utilizar APIs, webhooks e uma camada intermediária para transportar e transformar informações entre os sistemas.
Preciso saber programar?
Para integrações simples, algumas ferramentas podem reduzir a necessidade de programação. Entretanto, projetos personalizados envolvendo OAuth, tratamento de erros, deduplicação e múltiplos sistemas normalmente exigem conhecimento técnico.
Posso criar contatos automaticamente no RD Station?
Sim. A API v2 do RD Station CRM disponibiliza endpoint para criação de contatos.
Posso criar negociações automaticamente?
Sim. A API também disponibiliza endpoint para criação de negociações, permitindo inclusive informar a etapa do funil por meio de stage_id.
O token do RD Station nunca expira?
Não. O access_token do RD Station CRM possui validade de duas horas, portanto a integração precisa implementar renovação utilizando o refresh_token.
O que acontece se o limite de API for ultrapassado?
A API pode retornar 429 Too Many Requests. Por isso, é importante controlar a quantidade de chamadas e implementar mecanismos de espera e novas tentativas.
Posso enviar informações coletadas no WhatsApp para o CRM?
Sim, desde que a arquitetura esteja corretamente configurada e o tratamento dos dados esteja adequado às regras aplicáveis de privacidade e proteção de dados.
Preciso usar middleware?
Não necessariamente. Entretanto, conforme a integração cresce, uma camada intermediária pode facilitar autenticação, logs, transformação de dados, filas, retry e monitoramento.
Posso integrar outros sistemas além do RD Station?
Sim. Uma arquitetura bem planejada pode conectar chatbot, CRM, ERP, sistemas internos, plataformas de pagamento, BI e outras aplicações.
API e webhook são a mesma coisa?
Não. A API permite realizar operações entre sistemas, enquanto o webhook normalmente serve para notificar automaticamente que determinado evento aconteceu. Os dois podem trabalhar juntos.
Conclusão
Aprender como configurar API para RD Station e BotConversa significa muito mais do que conectar duas plataformas.
Na prática, significa criar uma infraestrutura capaz de transformar conversas em dados, dados em oportunidades e oportunidades em vendas.
Primeiramente, é necessário mapear o processo.
Depois, deve-se configurar a aplicação do RD Station, implementar OAuth, proteger credenciais e estruturar os endpoints.
Em seguida, é preciso configurar o BotConversa, definir campos, criar os gatilhos e estabelecer como as informações serão encaminhadas.
Além disso, a integração deve considerar deduplicação, tratamento de erros, renovação de tokens, limites de requisições, segurança e LGPD.
Finalmente, depois que tudo estiver funcionando, é fundamental acompanhar os indicadores e otimizar o processo continuamente.
Desse modo, a integração deixa de ser apenas uma automação técnica e passa a funcionar como uma verdadeira infraestrutura comercial.
BotConversa captura e conversa.
A API conecta.
O RD Station organiza.
A estratégia transforma esses dados em oportunidades.
Portanto, quando essas tecnologias são utilizadas de maneira integrada, empresas podem construir operações de marketing e vendas mais rápidas, organizadas e escaláveis.
Se sua empresa precisa conectar chatbot, WhatsApp, CRM, automação, IA e marketing digital, o próximo passo é estruturar essa arquitetura de acordo com seus processos comerciais, evitando integrações improvisadas e criando uma operação preparada para crescer.
