RD Station API: como usar para ligar o CRM aos anúncios

A RD Station API não é uma só: são APIs separadas para o RD Station Marketing, o CRM, o Conversas e o Exact Spotter, cada uma com autenticação, endereços e limites próprios, segundo a documentação para desenvolvedores. Para ligar anúncios ao CRM, as duas que importam são a do Marketing, que recebe eventos de conversão, oportunidade e venda, e a do CRM, que avisa por webhook quando um negócio muda. Nenhuma delas fala direto com o Google, a Meta ou o LinkedIn: entre o aviso do RD e o envio à plataforma de anúncios, existe um conector que alguém precisa montar.

Foi essa a lacuna que encontramos ao ler o que o RD Station publica. A documentação explica bem cada endereço e cada limite, mas não mostra o caminho inteiro do clique até a devolução da venda. O texto abaixo junta as duas coisas: o que a API faz, os limites que mudam o desenho da integração e o que dá para fazer sem programar. O fluxo geral, que vale para qualquer CRM, está em integração de anúncios com CRM.

Qual RD Station API usar para anúncios?

Duas, para papéis diferentes.

A API do RD Station Marketing recebe eventos. O endereço base é https://api.rd.services, com respostas em JSON e acesso só por TLS 1.3. Ela aceita dois métodos de autenticação. A chave de API serve apenas para enviar eventos de conversão que criam e atualizam contatos, e a documentação a recomenda para formulários e sistemas internos. O OAuth2 é o método para tudo o mais: enviar eventos, marcar e desmarcar oportunidades, registrar vendas, atualizar contatos e consultar dados.

A API do RD Station CRM (versão 2) tem uma peça que o Marketing não tem: os webhooks. Você cadastra um endereço seu, e o CRM envia um aviso a cada evento de negócio.

Um cuidado de segurança que a gente repete em toda implantação: a chave de API é fácil de usar direto no navegador, dentro do formulário, e aí qualquer visitante consegue lê-la. Chave e tokens OAuth ficam no servidor, nunca no código da página.

Como enviar a conversão de um clique para o RD Station?

O envio é uma chamada POST para /platform/events com o tipo de evento CONVERSION. Os campos obrigatórios, segundo a documentação, são:

• event_type com o valor CONVERSION e event_family com o valor CDP, o único aceito hoje;
• dentro do payload, o conversion_identifier (o nome do evento de conversão) e o email do contato.

Para guardar de onde veio o clique, o RD tem campos de tráfego: traffic_source, traffic_medium, traffic_campaign e traffic_value, que correspondem a origem, mídia, campanha e termo das UTMs. Se você enviar o cookie __trf.src no traffic_source, os outros três precisam ir vazios. O client_tracking_id recebe o valor do cookie _rdtrk, que liga o evento à navegação anterior do visitante.

A especificação não cita gclid, fbclid nem li_fat_id. O caminho que usamos é criar campos personalizados na conta (por exemplo, um para o gclid e outro para o li_fat_id) e enviá-los no mesmo payload com o prefixo cf_ e o nome do campo, sem espaços. Esses campos são o que permite devolver a venda ao clique depois, e a lista do que gravar está na seção de dados do guia de integração de anúncios com CRM. As UTMs, por sua vez, seguem o padrão do gerador de UTM.

Como o CRM avisa que o negócio mudou de etapa?

Pelo webhook, com três tipos de evento: crm_deal_created, crm_deal_updated e crm_deal_deleted. A documentação registra que o evento de negócio está disponível nos planos Basic e PRO do CRM, e outra página cita também o Advanced, então confira o seu plano antes de planejar.

O aviso traz o negócio inteiro: valores, previsão, datas, status, usuário, funil, etapa, origem, campanha, motivo de perda, campos personalizados e produtos. Cada envio vem com um transaction_uuid único e um event_timestamp. O formato é fixo, e a documentação diz que não dá para personalizá-lo.

O ponto que pesa no desenho: não existe um evento "mudou de etapa". Existe o crm_deal_updated, que dispara a cada atualização do negócio, seja a etapa, o valor ou uma anotação. A documentação não descreve como detectar a mudança de etapa, e o caminho natural, que é uma inferência nossa e não uma instrução do RD, é guardar a última etapa vista de cada negócio e comparar com a do aviso novo. Use o transaction_uuid para ignorar o mesmo aviso quando ele chegar duas vezes.

O endereço que recebe o webhook precisa aceitar JSON, ter certificado de segurança e responder 2xx aos POST. Dá para definir um cabeçalho e uma chave que o CRM envia em toda chamada: use isso, para que o seu endereço recuse quem não os mandar. Um webhook aberto, sem esse segredo, aceita aviso falso de qualquer um.

Quais limites da RD Station API mudam o desenho?

A página de limites de requisição mostra que o envio de eventos tem teto por lead e por conta:

Passar do limite devolve o erro 429 (muitas requisições). Duas consequências práticas:

1. Um reenvio em lote de eventos antigos precisa respeitar o limite. Para reenviar 10 mil oportunidades antigas, são cerca de 84 minutos a 120 por minuto, e 20 minutos a 500. Faça fila e trate o 429 com espera, em vez de reenviar em laço.
2. Atualizar o mesmo contato mais de 24 vezes no dia é bloqueado. Se o seu conector reescreve o contato a cada mudança de etapa, junte as mudanças num só envio.

O envio em lote aceita corpo de até 0,2 MB e os tipos de evento CONVERSION, OPPORTUNITY, SALE e OPPORTUNITY_LOST, entre outros. A documentação consultada não detalha os campos de oportunidade, venda e perda, então valide no teste com um contato real.

O RD Station integra sozinho com o Google Ads e a Meta?

Em parte, e só pelo lado do Marketing. A página de integrações do RD descreve a integração "Conversões Otimizadas no Google Ads", que envia ao Google, de servidor a servidor, os envios de formulário capturados no RD Station Marketing e os leads marcados como oportunidade. Cada evento pode ser ligado a uma ação de conversão diferente, e o painel mostra o que o Google aceitou. A integração é paga à parte, e o preço está na página do produto.

Os públicos para anúncios funcionam a partir das segmentações do RD Marketing: o RD envia a lista para a conta do Google ou da Meta, que reconhece quem tem conta com o mesmo e-mail. O número de públicos que você pode sincronizar muda conforme o plano, então confira o limite atual do seu antes de desenhar a estrutura.

O que não encontramos na documentação oficial foi uma integração nativa que devolva à Meta ou ao LinkedIn a etapa do negócio no CRM. Para isso, o desenho é o do webhook: o CRM avisa, um conector recebe, converte e envia à API da plataforma. Para a Meta, o destino é a API de Conversões, e para o Google, a importação de conversões offline. O conector pode ser uma ferramenta de automação ou um servidor seu, e o ponto de atenção é o mesmo nos dois: guardar o identificador do clique no RD, enviar a data da etapa e evitar o envio em duplicidade.

Quais erros mais aparecem na integração com o RD Station?

• Campo personalizado criado depois do envio, o que faz o dado do clique ficar de fora dos leads antigos.
• Etapa do funil renomeada no CRM sem avisar quem mantém o conector, que passa a comparar com o nome antigo.
• Webhook sem cabeçalho de autenticação.
• Conversão enviada com a data do envio e não a da etapa.
• Importação manual esperando disparar webhook: a documentação avisa que importações e atualizações manuais de contatos não disparam o aviso. Teste se o mesmo vale para os negócios da sua conta.
• Ninguém olhando o erro 429 ou as respostas fora de 2xx, e a integração parada por semanas.

Perguntas frequentes

A API do RD Station é gratuita?

A documentação para desenvolvedores não fala de preço de API. Os limites mudam por plano (Light, Basic, Pro e Advanced), e o webhook de negócio do CRM depende do plano contratado. Confira no seu contrato antes de contar com um recurso.

Qual é a diferença entre chave de API e OAuth2 no RD Station Marketing?

A chave de API só envia eventos de conversão para criar e atualizar contatos. O OAuth2 cobre o resto: oportunidade, venda, consulta e atualização de contato. Para devolver etapas do funil ao RD, use OAuth2 e guarde os tokens no servidor.

O RD Station envia a venda para o Google Ads?

Há uma integração paga do RD Marketing que envia ao Google os formulários e os leads marcados como oportunidade. Para devolver a venda registrada no CRM, a documentação oficial que conferimos não traz recurso nativo: o caminho é um webhook mais um conector que envie o evento ao Google.

Quantos eventos por minuto o RD Station aceita?

Para o envio de eventos, 120 por minuto por conta nos planos Light, Basic e Pro e 500 por minuto no Advanced, com teto de 120 eventos por lead a cada 24 horas. Acima disso a API devolve o erro 429.

Sua venda no RD Station chega de volta aos anúncios?

Fale com a Summia. A gente desenha o webhook, os campos de clique e o envio para o Google, a Meta e o LinkedIn, e confere se o dado está chegando inteiro.

Leia também

• Integração de anúncios com CRM
• Integração HubSpot com Google, Meta e LinkedIn Ads
• CRM e funil de vendas
• Por que as conversões não batem com o CRM