# Integração RD Station

![Integração RD Station](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOEpsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--48a28bd4c4acdf194e0cac7d5f5de7514f4a6512/simplesdesk-rdstation.png)

Conecte o **RD Station Marketing** ao SimplesDesk e feche o ciclo entre marketing e atendimento: cada contato novo e conversa iniciada no WhatsApp vira conversão no RD (alimentando automações e lead scoring), oportunidades ganhas viram eventos de funil com valor, e leads convertidos no RD chegam aqui automaticamente via webhook — podendo até iniciar um fluxo.

## Quando utilizar

- Marketing roda no RD Station e **vendas/atendimento acontecem no WhatsApp**;
- Você quer que o **lead scoring e as automações do RD enxerguem o WhatsApp**: quem chamou, quem virou oportunidade, quem comprou;
- Leads que convertem em landing pages do RD devem **receber atendimento imediato** por fluxo.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **RD Station**.
2. Preencha a **API Key** (RD Station → Integrações → Chaves de API) — obrigatória, habilita o envio de conversões.
3. (Opcional) Ative a **Sincronização avançada (OAuth)**: crie um app na RD Station App Store, informe `client_id`, `client_secret` e o **código de autorização** gerado ao autorizar o app na sua conta RD. O OAuth habilita eventos de funil (oportunidade ganha/perdida), tags e consulta de perfil do lead.
4. Clique em **Testar e conectar**.

> 💡 O RD Station identifica leads **pelo e-mail** — contatos sem e-mail não são sincronizados. Colete o e-mail na conversa (com fluxo ou IA) para aproveitar a integração ao máximo.

---

## O que é enviado automaticamente

Com a integração conectada, sem configurar mais nada:

- **Contato novo** → conversão `novo-contato-simplesdesk` no RD (com nome, telefone e tag `simplesdesk`);
- **Conversa iniciada** → conversão `conversa-iniciada-simplesdesk`;
- **Oportunidade marcada / ganha / perdida** no CRM → evento de funil no RD — a venda vai com o **valor** da oportunidade (requer OAuth);
- Leads criados **pelo webhook do RD** não geram conversão de volta (anti-eco).

## Webhook de entrada (RD → SimplesDesk)

No card da integração você encontra a **URL do webhook**. Cadastre-a nos webhooks do RD Station Marketing (conversão / oportunidade): leads convertidos lá são **criados/atualizados aqui automaticamente** com a etiqueta `rd-station` — prontos para segmentar e disparar fluxos.

---

## Agente de IA

Nas configurações do assistente (**Central IA → seu assistente → Integrações**), ative o **RD Station Marketing**:

| Capacidade | O que a IA passa a fazer |
| --- | --- |
| **Perfil do lead** | Consulta pelo e-mail: nome, tags, cidade, cargo, empresa e campos personalizados — contexto de marketing na conversa |
| **Adicionar tags** | Marca o interesse ou estágio identificado na conversa (acumula, não substitui) e dispara as automações do RD |

## Nós de fluxo

No editor de fluxos, a categoria **RD Station** traz três nós:

- **RD Station: Buscar lead** — busca pelo e-mail (do contato ou informado) e grava o perfil em `{{variables.rd_email}}`, `{{variables.rd_nome}}`, `{{variables.rd_lead_stage}}` e `{{variables.rd_tags}}`. Saída verde = encontrado, amarela = não encontrado. Exige OAuth;
- **RD Station: Registrar conversão** — registra uma conversão com o identificador que você definir (ex.: `contato-whatsapp`) para o e-mail do contato. Funciona com API Key **ou** OAuth. Grava `{{variables.rd_conversao}}`;
- **RD Station: Marcar oportunidade** — marca o lead como **Oportunidade**, **Ganho** (com valor da venda) ou **Perdido** (com motivo), no funil informado. Exige OAuth.

Em caso de erro, a mensagem fica em `{{variables.rd_erro}}`.

## Gatilho: Evento de integração

O gatilho **Evento de integração** escuta o evento **RD Station → Conversão de lead** (`conversao`): sempre que o webhook do RD entrega uma conversão, o fluxo dispara com as variáveis `{{variables.rd_email}}` · `{{variables.rd_nome}}` · `{{variables.rd_lead_stage}}` · `{{variables.rd_conversao}}`.

---

### Exemplo: conversão do WhatsApp para o RD

Objetivo: quem pede orçamento no WhatsApp deve entrar na automação de nutrição do RD.

1. Fluxo com gatilho de palavra-chave ("orçamento") ou botão do menu;
2. **Coletar Dados** pede o e-mail e salva em `{{variables.email}}` (atualizando o contato);
3. **RD Station: Registrar conversão** com identificador `orcamento-whatsapp`;
4. No RD, crie a automação disparada por essa conversão — e-mails de nutrição, notificação ao vendedor, mudança de estágio.

Quer o caminho inverso? Use o gatilho **Evento de integração → Conversão de lead** para dar boas-vindas via WhatsApp a quem converteu na landing page — "Olá {{variables.rd_nome}}, recebemos seu interesse!".

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — do primeiro fluxo ao gatilho de evento de integração.

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.
