PicChat

Integrações

Receber leads do RD Station Marketing

POSThttps://api.picchat.com.br/contacts/rdstation

Rota para o webhook do RD Station Marketing (gatilhos de conversão e de oportunidade). Recebe o corpo do RD, { "leads": [ ... ] }, e cria ou atualiza um contato por lead: nome, e-mail, celular, Fonte original e Fonte detalhada (só se o contato ainda não tiver fonte), Fase do ciclo de vida, rd_ultima_conversao e os campos cf_* que existirem como propriedade na conta. Não envia mensagem: as propriedades que mudam acionam os Fluxos de Trabalho da conta. Como o RD não permite cabeçalhos, esta é a única rota que aceita o token em ?token=; o cabeçalho Authorization também funciona. Passo a passo no guia RD Station Marketing.

Autenticação: Bearer tokenPermissão: Token da conta, no cabeçalho Bearer ou em ?token=.

Parâmetros de consulta (query)

  • tokenstring

    Token de integração da conta. Use quando não der para mandar o cabeçalho Authorization (caso do RD).

Corpo da requisição (JSON)

Campos do corpo

  • leadsarray<object>obrigatório

    Leads no formato do webhook do RD.

  • leads[].namestring

    Nome completo; separado em nome e sobrenome no primeiro espaço.

  • leads[].emailstring

    E-mail. Se vier mal formado, o lead entra só com o celular.

  • leads[].mobile_phonestring

    Celular. Sem ele, usa personal_phone.

  • leads[].personal_phonestring

    Telefone pessoal.

  • leads[].lead_stagestring

    Lead, Lead Qualificado ou Cliente → Fase do ciclo de vida.

  • leads[].opportunitystring

    "true" marca a fase como Oportunidade.

  • leads[].last_conversionobject

    Última conversão: content.identificador vira rd_ultima_conversao; conversion_origin (source, medium, campaign) vira Fonte original e Fonte detalhada.

  • leads[].custom_fieldsobject

    Campos personalizados cf_*, gravados na propriedade de mesmo nome interno.

Respostas

201Resumo do lote. Um lead com erro não derruba os outros.

  • receivedinteger

    Leads no corpo.

  • createdinteger

    Contatos criados.

  • updatedinteger

    Contatos atualizados.

  • skippedinteger

    Leads sem celular e sem e-mail.

  • errorsinteger

    Leads que falharam.

498Token ausente, inválido, de conta inexistente ou revogado.