Nó RD Station

O nó de workflow RD Station chama a RD Station Marketing API para gerenciar contatos, leads e eventos de conversão. Use-o para sincronizar interações do WhatsApp na base de leads do RD Station e rastrear conversões de marketing.

ID do nó no editor: rdstation_request
Base URL: https://api.rd.services/platform/
Auth: Authorization: Bearer {{rdstation_access_token}}

O que faz

• Envia requisições HTTP autenticadas para endpoints da plataforma RD Station
• Suporta GET, POST, PUT, PATCH e DELETE
• Retorna status HTTP, data de resposta e headers de resposta
• Inclui templates de operação para contatos, leads e eventos

Pré-requisitos

1. Uma conta RD Station Marketing
2. Um OAuth access token ou API token com escopos apropriados
3. Chave de integração rdstation_access_token em Configurações → Chaves de API

Obtendo um access token

O RD Station usa OAuth 2.0 para autenticação da API:

1. Crie um app na RD Station App Store / portal de desenvolvedor
2. Complete o fluxo de autorização OAuth para obter um access token
3. Armazene o token como rdstation_access_token nas chaves de integração do WhatsWave

Access tokens expiram. Para automações em produção, implemente refresh de token ou use uma estratégia de token de longa duração conforme as diretrizes atuais da API do RD Station.

Como configurar

Passo 1 — Definir credenciais

1. Abra Configurações → Chaves de API
2. Adicione a chave de integração:
   • Nome: rdstation_access_token
   • Valor: seu RD Station OAuth access token

Header padrão: Authorization: Bearer {{rdstation_access_token}}

Passo 2 — Adicionar o nó

Arraste RD Station da paleta Marketing para o canvas do workflow.

Passo 3 — Escolher um template de operação

Passo 4 — Configurar campos da requisição

Exemplo — criar contato do WhatsApp (POST):

• URL: https://api.rd.services/platform/contacts
• Method: POST
• Body:

{
  "email": "{{contact.email}}",
  "name": "{{contact.name}}",
  "mobile_phone": "{{contact.phone}}",
  "tags": ["whatsapp", "inbound"]
}

Exemplo — atualizar contato (PATCH):

• URL: https://api.rd.services/platform/contacts/{{variables.rd_contact_uuid}}
• Method: PATCH
• Body:

{
  "name": "{{contact.name}}",
  "tags": ["whatsapp", "qualified"]
}

Exemplo — registrar evento de conversão (URL customizada):

O rastreamento de conversão do RD Station frequentemente usa a Events API. Configure um POST customizado no endpoint de eventos com o payload exigido pelo seu plano RD Station e tipo de integração.

Todos os campos suportam variáveis de workflow.

Passo 5 — Usar dados da resposta

Contact UUID: {{rdstation_1.data.uuid}}
Email: {{rdstation_1.data.email}}

Armazene o UUID do contato em uma variável de workflow ou campo customizado de contato para atualizações.

Saídas do nó

Dicas e boas práticas

• E-mail é obrigatório para a maioria das operações de contato no RD Station
• Contatos RD Station usam identificadores UUID — armazene UUIDs, não IDs numéricos
• Use tags para segmentar leads vindos do WhatsApp (whatsapp, inbound, qualified)
• Para lead scoring e mudanças de estágio no funil, combine atualizações de contato com automações de workflow RD Station disparadas por mudanças de tag
• Configure webhooks do RD Station para envios de formulário e eventos de CRM → workflows Webhook do WhatsWave
• Expiração de token causa erros 401 — monitore e renove tokens proativamente
• Paginate endpoints de listagem com parâmetros de query conforme a documentação da API RD Station
• Para a Conversion API legada (pixels/eventos de tracking), consulte a documentação RD Station para o endpoint correto — pode diferir da API de contatos da plataforma

Exemplos de casos de uso

Captura de lead WhatsApp → contato RD Station

1. Gatilho — novo contato com e-mail coletado via Agente
2. RD Station POST — criar contato com telefone e tags
3. Variable — salvar {{rdstation_1.data.uuid}}
4. Enviar mensagem — resposta de confirmação

Tag em leads qualificados

1. AI Agent qualifica lead
2. RD Station PATCH — adicionar tag qualified ao contato
3. Automação interna RD Station envia sequência de nurture por e-mail

Webhook de formulário → follow-up WhatsApp

1. Gatilho Webhook — envio de formulário RD Station (via webhook RD)
2. Enviar mensagem — abordagem imediata no WhatsApp
3. RD Station PATCH — adicionar tag whatsapp-contacted

FAQ

Por que 401 Unauthorized?
Access token expirado ou inválido. Reautorize o app OAuth e atualize rdstation_access_token.

Qual a diferença entre contatos e leads?
No RD Station Marketing, contatos são a base unificada de leads. O endpoint /leads pode retornar visões específicas de lead conforme a configuração da sua conta — consulte a documentação atual da API.

Posso disparar automações de e-mail do RD Station?
Indiretamente — atualize tags ou campos de contato que as automações RD Station monitoram, ou use os gatilhos nativos de workflow do RD Station.

Preciso do RD Station CRM (produto separado)?
Este nó aponta para a API da plataforma Marketing do RD Station. O RD Station CRM tem endpoints separados — use o nó HTTP para APIs específicas de CRM, se necessário.

Como isso difere do nó HubSpot?
O RD Station é otimizado para marketing inbound e fluxos de geração de leads no Brasil. O HubSpot oferece recursos de CRM mais amplos. Use a plataforma que for sua fonte da verdade.

Referência da API

Relacionados

• Visão geral de Marketing
• Variáveis no workflow
• Webhooks recebidos
• Nó HTTP