No RD Station todos os registros de pessoas são referidos como Contatos, independentemente de serem classificados como Leads, Leads Qualificados ou Clientes a partir de uma perspectiva de vendas.
Ao criar um Contato ele pode ser qualificado com um conjunto de campos padrão, como email, nome, cargo, empresa, cidade, estado, etc.. O campo padrão chave de identificação dos contatos dentro do RD Station é o "email" deste Contato, que sempre será único.
Além disso, é possível adicionar informações adicionais ao Contato a partir do preenchimento de Campos Personalizados criados para a sua conta. Os campos personalizados podem ser lidos e gravados como os campos padrão.
O objetivo dessa API é possibilitar a gestão de informações de Contatos em uma conta do RD Station, para isso, fornecemos algumas rotas que proporcionam flexibilidade de integração com a sua solução.
Observe os detalhes sobre cada uma das APIs:
Apenas cria um novo contato na Base de Leads; se o contato já existir, ocorrerá o erro EMAIL_ALREADY_IN_USE.
Não há o registro de um Evento de Conversão no histórico do contato.
As tags enviadas na requisição são acrescidas no contato.
Cria ou atualiza um contato existente na Base de Leads.
Não há o registro de Evento de Conversão no histórico do contato.
Caso o contato já exista, as Tags inseridas no contato são substituídas pelas novas tags enviadas na requisição.
Atenção: Ao atualizar o contato pelo email, o parâmetro "email" não deve ser enviado no Body.
Apenas atualiza um contato já existente na Base de Leads; se o contato não existir, ocorrerá o erro RESOURCE_NOT_FOUND.
Não há o registro de Evento de Conversão no histórico do contato.
As Tags enviadas são acumuladas no Perfil do Lead, ou seja, são acrescentadas em adição às tags existentes.
Como registrar conversões:
Se o seu objetivo for criar ou atualizar o contato com um Evento de Conversão, você pode utilizar os seguintes métodos:
Bases Legais
A API de Contatos aceita a atualização de Bases Legais:
| Campo | Tipo | Parâmetros válidos | Descrição |
|---|---|---|---|
| category | String | communications | A única categoria aceita é "communications". |
| type | String | pre_existent_contract, consent, legitimate_interest, judicial_process, vital_interest or public_interest | Qual base legal autoriza o tratamento de dados pessoais. |
| status | String | granted or declined | Valores aceitos: "granted" para confirmar o consentimento e "declined" para indicar que o consentimento foi recusado. |
Saiba mais sobre os conceitos de Bases Legais aqui.