> For the complete documentation index, see [llms.txt](https://multiagents.gitbook.io/multiagents-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://multiagents.gitbook.io/multiagents-docs/documentacao-de-tools/readme/rd-station-v2.md).

# RD Station V2

## RD Station V2

Este guia explica como conectar o **RD Station CRM** ao Multiagents para sincronizar automaticamente leads, oportunidades, contatos e tarefas entre os dois sistemas.

> **Esta integração é exclusivamente para o RD Station CRM** (`crm.rdstation.com`). Ela não conecta o RD Station Marketing.

***

#### Antes de começar

Confira estes três pontos — são a causa da maioria das falhas de configuração:

* **Plano Basic ou superior** no RD Station CRM. A API de funis não responde em planos abaixo disso.
* **Pelo menos um funil criado** no RD Station CRM. Sem funil, a conexão não é concluída.
* **Token de um usuário administrador.** O token concede acesso total à conta; um usuário sem permissão de admin não enxerga todos os dados.

***

#### O que a integração faz

A sincronização acontece nos dois sentidos, mas **não é simétrica** — o que vai é mais do que o que volta.

**Do Multiagents para o RD Station**

| Evento no Multiagents    | Efeito no RD Station CRM                              |
| ------------------------ | ----------------------------------------------------- |
| Novo lead                | cria a oportunidade no funil e estágio mapeados       |
| Mudança de estágio       | move a oportunidade para o estágio correspondente     |
| Lead ganho               | marca a oportunidade como ganha e registra o motivo   |
| Lead perdido             | marca a oportunidade como perdida e registra o motivo |
| Nota adicionada          | cria uma anotação na oportunidade                     |
| Contato adicionado       | cria o contato vinculado                              |
| Lembrete criado          | cria uma tarefa                                       |
| Mudança de temperatura   | atualiza a oportunidade                               |
| Mudança de ciclo de vida | atualiza a oportunidade                               |
| Atualização do negócio   | atualiza a oportunidade                               |
| Lead arquivado           | atualiza a oportunidade                               |

**Do RD Station para o Multiagents**

Depende de **cadastrar o webhook** (Passo 5). Voltam apenas quatro situações:

| Evento no RD Station CRM | Efeito no Multiagents              |
| ------------------------ | ---------------------------------- |
| Negociação criada        | cria o lead correspondente         |
| Mudança de etapa         | move o lead para o estágio mapeado |
| Negociação ganha         | marca o lead como ganho            |
| Negociação perdida       | marca o lead como perdido          |

> **Notas, contatos e tarefas não voltam.** Criar uma anotação no RD Station não gera nota no Multiagents. O caminho de volta cobre só o ciclo do negócio.

***

#### Passo 1 — Obter o Token da API no RD Station CRM

1. Acesse [**https://crm.rdstation.com/login**](https://crm.rdstation.com/login) e faça login
2. Clique no seu **avatar/nome**, no canto inferior esquerdo da barra lateral
3. Vá em **"Configurações"**
4. No menu lateral, clique em **"Integrações"**
5. Na seção **"Token da API"**, clique em copiar

> **Atalho:** já logado, <https://crm.rdstation.com/configuracoes/integracoes> leva direto a essa tela. Se o endereço não abrir, use a navegação pelo menu descrita acima.

<figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FPpILvvOvtUsWVBCv5IHf%2Fimage.png?alt=media&#x26;token=11f1fb6e-5917-442c-a518-0f918834ad2b" alt=""><figcaption></figcaption></figure>

> **O token dá acesso total à conta do CRM.** Trate-o como senha: não compartilhe por e-mail ou chat, e use o token de um usuário administrador.

***

#### Passo 2 — Criar a Conexão no Multiagents

1. No painel do Multiagents (<https://app.multiagents.pro>), abra **Integrações** na barra lateral e clique em **Conexões**
2. Clique em **"Adicionar Conexão"**
3. Na categoria **CRM**, selecione **"RD Station CRM"**
4. Cole o token no campo de token da API

   > Dependendo da tela, o campo aparece como **"Token da API"** ou **"Token Pessoal"**. É o mesmo token do Passo 1.
5. Clique em **"Testar Conexão"**
6. Dê um nome à conexão (por exemplo, "RD Station — Equipe Vendas") e clique em **"Salvar"**

**O que o teste deve responder:**

```
RD Station CRM conectado. 3 funil(s) encontrado(s).
```

Se o número de funis vier zerado, o teste **falha** — e isso é proposital. Sem funil acessível a integração não tem onde criar oportunidade. Veja a seção de problemas.

***

#### Passo 3 — Adicionar a Ferramenta ao Trabalho

1. Abra o **Trabalho** onde a integração deve funcionar
2. Vá na aba **Ferramentas**
3. Clique em **"Adicionar Ferramenta"**
4. Na seção **CRM**, escolha **"RD Station CRM"**

***

#### Passo 4 — Configurar o funil e mapear os estágios

Depois de adicionar, clique no ícone de **engrenagem** da ferramenta.

**4.1 Selecionar a conexão**

Escolha a conexão criada no Passo 2.

**4.2 Selecionar o funil**

Um campo **"Funil"** lista os funis disponíveis no RD Station CRM. Escolha o que este Trabalho vai sincronizar.

**4.3 Mapear os estágios**

O mapeamento aparece assim que o funil é escolhido:

* **À esquerda:** os estágios do Trabalho no Multiagents
* **À direita:** os estágios do funil no RD Station

Para cada estágio do Multiagents, escolha o estágio correspondente no RD Station.

**Exemplo:**

| Estágio no Multiagents | Estágio no RD Station |
| ---------------------- | --------------------- |
| Novo Lead              | Cadastro              |
| Qualificação           | Contato               |
| Proposta               | Proposta              |
| Negociação             | Negociação            |
| Fechamento             | Fechamento            |

**4.4 Salvar**

Clique em **"Salvar e Fechar"**.

> ⚠️ **O mapeamento não é opcional.** Sem funil escolhido e sem estágios mapeados, **nada é sincronizado** — nem a criação da oportunidade. E um estágio deixado sem correspondência é **ignorado em silêncio**, nos dois sentidos: nada acontece e nenhum erro aparece. Se alguma movimentação não estiver refletindo, este é o primeiro lugar a conferir.

***

#### Passo 5 — Cadastrar o webhook (necessário para o sentido de volta)

Sem este passo, a sincronização funciona **apenas no sentido Multiagents → RD Station**. Negócios criados ou movidos diretamente no RD Station não chegam ao Multiagents.

São duas telas: primeiro você copia a URL no Multiagents, depois a cadastra no RD Station.

**5.1 Copiar a URL no Multiagents**

1. Volte à configuração da ferramenta **RD Station CRM** no seu Trabalho (o mesmo ícone de engrenagem do Passo 4)
2. Role até o campo **URL de Webhook**
3. Clique no **botão de copiar** ao lado do campo

> ⚠️ **Copie a URL desta tela. Não digite uma URL à mão, nem reaproveite a de outro Trabalho.** Ela contém os identificadores da sua empresa e do seu Trabalho, e o endereço muda conforme o ambiente. Uma URL montada manualmente pode ser **aceita pelo RD Station e mesmo assim nunca entregar nada** — o cadastro parece ter funcionado e nenhum evento chega.

\[INSERIR IMAGEM: o campo "URL de Webhook" na configuração da ferramenta, com o botão de copiar]

**5.2 Cadastrar no RD Station**

1. Acesse [**https://crm.rdstation.com/configuracoes/integracoes**](https://crm.rdstation.com/configuracoes/integracoes)

   > Pelo menu: **avatar/nome** (canto inferior esquerdo) → **Configurações** → **Integrações**. É a mesma tela onde você pegou o token no Passo 1.
2. Localize a seção **Webhooks** e clique em **"Adicionar webhook"**
3. Preencha o formulário:

   | Campo   | O que preencher                 |
   | ------- | ------------------------------- |
   | URL     | cole a URL copiada em 5.1       |
   | Método  | `POST`                          |
   | Eventos | marque os dois da tabela abaixo |
4. Clique em **Salvar**

\[INSERIR IMAGEM: o formulário de cadastro de webhook no RD Station, com os dois eventos marcados]

**5.3 Quais eventos marcar**

| Marcar? | Rótulo na tela do RD Station | Nome técnico          | Para que serve                                                  |
| ------- | ---------------------------- | --------------------- | --------------------------------------------------------------- |
| ✅       | **Negociação criada**        | `crm_deal_created`    | cria o lead no Multiagents quando o negócio nasce no RD Station |
| ✅       | **Negociação atualizada**    | `crm_deal_updated`    | traz mudança de etapa, ganho e perda                            |
| ❌       | Contato criado               | `crm_contact_created` | **não marque** — ver abaixo                                     |
| ❌       | Contato atualizado           | `crm_contact_updated` | **não marque** — ver abaixo                                     |

**Por que apenas dois.** O rótulo em português e o nome técnico são a mesma coisa vista de dois lugares: o rótulo é o que aparece na caixinha do RD Station, o nome técnico é o que viaja na requisição. A diferença real está nos eventos de **contato**: a Multiagents recebe, mas não faz nada com eles — só eventos de negociação são processados. Marcá-los não causa erro, mas cria a expectativa falsa de que contatos criados no RD Station vão aparecer no Multiagents. Não vão.

Os dois eventos de negociação cobrem **tudo** que volta: criação, mudança de etapa, ganho e perda.

**5.4 Confirmar que funcionou**

1. No RD Station, crie um negócio de teste no funil que você mapeou no Passo 4
2. Abra o Trabalho no Multiagents
3. O lead correspondente deve aparecer no estágio mapeado, em segundos

Se não aparecer, siga a seção *"Uma movimentação feita no RD Station não refletiu"*, mais abaixo.

**Alternativa via Automações.** Se preferir, no RD Station é possível criar uma automação com gatilho *"Quando um negócio mudar de etapa"* e ação *"Enviar webhook"*, usando a mesma URL. Isso cobre a movimentação, mas **não** cobre a criação de negócio — para isso o webhook de *Negociação criada* continua necessário.

***

#### Como funciona na prática

**Um lead novo entra no Multiagents**

1. O lead chega por WhatsApp, widget ou outro canal
2. O agente de IA qualifica e move para um estágio
3. A integração então:
   * busca ou cria a **organização** no RD Station, pelo nome
   * busca ou cria o **contato**, por e-mail ou telefone
   * cria a **oportunidade** no funil escolhido, no estágio mapeado

**O lead muda de estágio**

A oportunidade é movida para o estágio correspondente no RD Station.

**O lead é ganho**

A oportunidade é marcada como ganha e recebe uma anotação com o motivo e o valor.

**Um negócio nasce no RD Station**

Com o webhook cadastrado, o Multiagents recebe o evento e **cria o lead correspondente**. Sem o webhook, esse negócio simplesmente não existe do lado do Multiagents.

***

#### Resolução de problemas

**"Testar Conexão" falha com token inválido**

> Token inválido ou sem permissão. A API do RD Station CRM requer plano Basic ou superior.

Duas causas possíveis, nesta ordem:

* o token foi copiado incompleto — copie novamente, do começo ao fim
* a conta está num plano abaixo de Basic, em que a API não responde

**"Testar Conexão" diz que nenhum funil foi retornado**

> Conectado, mas nenhum funil foi retornado. Verifique se o token tem permissão de leitura dos funis (a API exige plano Basic ou superior).

O token é válido, mas não enxerga funis. Confirme que existe pelo menos um funil criado no RD Station e que o token é de um usuário **administrador**.

**Os funis não aparecem no campo de seleção**

Mesma causa do item anterior. Confirme primeiro que o "Testar Conexão" passou.

**A oportunidade não foi criada no RD Station**

Na ordem em que vale conferir:

1. **O funil e os estágios estão mapeados?** Sem isso nada é enviado
2. **O estágio em questão tem correspondência?** Estágio sem mapeamento é ignorado sem aviso
3. **O lead tem e-mail ou telefone?** Sem um dos dois, não há como criar o contato

**Uma movimentação feita no RD Station não refletiu no Multiagents**

1. O webhook foi cadastrado, com a URL **copiada da tela**?
2. Os eventos **Negociação criada** e **Negociação atualizada** estão marcados?
3. O estágio de destino está mapeado na configuração da ferramenta?

**Erro ao criar contato no RD Station**

Costuma ser limite de contatos do plano no RD Station. Verifique o plano da conta ou remova contatos inativos.

> Se o problema persistir depois dessas verificações, acione o suporte com o nome da conexão, o Trabalho envolvido e o horário aproximado — a análise precisa ser feita nos registros internos.

***

#### Informações técnicas

| Item                           | Valor                                              |
| ------------------------------ | -------------------------------------------------- |
| Produto integrado              | RD Station **CRM** (não é o RD Station Marketing)  |
| API base                       | `https://crm.rdstation.com/api/v1`                 |
| Autenticação                   | token estático, enviado como parâmetro de consulta |
| Plano mínimo                   | Basic (a API de funis não responde abaixo disso)   |
| Eventos enviados               | 11                                                 |
| Eventos recebidos              | `crm_deal_created` e `crm_deal_updated`            |
| Pré-requisito de sincronização | funil selecionado **e** estágios mapeados          |
| Identificadores                | strings no formato ObjectId                        |
