RD Station Marketing

Com um webhook do RD Station Marketing, cada lead que converte (ou vira oportunidade) é criado ou atualizado como contato na PicChat, com origem, estágio e a última conversão. A partir daí, um Fluxo de Trabalho da conta decide o que fazer: colocar na pipeline, disparar uma automação, criar tarefa.

Esta rota não envia mensagem. Ela só cuida do contato. O envio fica com o Fluxo de Trabalho que você liga à propriedade rd_ultima_conversao, como mostrado abaixo.

Antes de começar

1. Um token de integração da conta (veja Autenticação e tokens). Crie um só para o RD Station.
2. A propriedade rd_ultima_conversao na conta. Peça ao suporte da PicChat para ativar a integração, que ela é criada para você.

Configurar o webhook no RD

O RD só deixa configurar a URL do webhook, sem cabeçalhos. Por isso esta rota, e só ela, aceita o token na própria URL:

https://api.picchat.com.br/contacts/rdstation?token=SEU_TOKEN

No RD Station Marketing, em Integrações › Webhooks, crie um webhook com:

Para os dois gatilhos, crie dois webhooks com a mesma URL.

O token vai na URL e fica visível para quem tem acesso às integrações do RD. Use um token exclusivo para o RD e, se alguém sair do time, revogue e gere outro no painel da PicChat.

O que é gravado no contato

O contato é procurado pelo celular e pelo e-mail do lead. Se existir, é atualizado; se não, é criado.

• Lead sem celular e sem e-mail é ignorado.
• Lead com e-mail mal formado entra só com o celular.
• Para receber um campo personalizado do RD, crie na PicChat uma propriedade com o nome interno igual ao do RD (por exemplo cf_curso_de_interesse).

Agir quando o lead converte

Cada propriedade que muda de valor nesta rota aciona os Fluxos de Trabalho da conta, como se alguém tivesse editado o contato no painel. No painel da PicChat, em Fluxos de Trabalho:

1. Crie um fluxo com gatilho de propriedade do contato em rd_ultima_conversao.
2. No operador, use existe para qualquer conversão, ou igual a o identificador de um formulário do RD (por exemplo form-matricula-2027) para tratar só aquele.
3. Nas ações, coloque o contato na pipeline, inscreva numa automação de disparo, atribua a um atendente etc.

O mesmo vale para as outras propriedades: um fluxo em Fase do ciclo de vida igual a Oportunidade, por exemplo, roda quando o RD marcar o lead como oportunidade.

Se o mesmo lead converter duas vezes no mesmo formulário, rd_ultima_conversao não muda e o fluxo não roda de novo. Isso evita mensagem repetida. Para tratar toda conversão, ligue o fluxo a outra propriedade que mude a cada envio.

Testar sem o RD

O corpo é o mesmo que o RD manda: { "leads": [ … ] }.

curl --request POST \
  --url 'https://api.picchat.com.br/contacts/rdstation?token=SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "leads": [
      {
        "name": "Maria Souza",
        "email": "maria.souza@example.com",
        "mobile_phone": "+55 11 99999-0000",
        "lead_stage": "Lead",
        "last_conversion": {
          "content": { "identificador": "form-matricula-2027" },
          "conversion_origin": { "source": "Busca Paga | Google", "medium": "cpc", "campaign": "matriculas-2027" }
        },
        "custom_fields": { "cf_curso_de_interesse": "Enfermagem" }
      }
    ]
  }'

A resposta resume o que foi feito com o lote:

{ "received": 1, "created": 1, "updated": 0, "skipped": 0, "errors": 0 }

Erros