Integração RD Station - Enviando dados de um bot para o RD Station

Siga os passos abaixo para realizar a integração entre o RD Station e o BLiP.

1. Instalando o Aplicativo do BLiP no RD Station

Para configurar um bot no RD Station, acesse o portal do BLiP, escolha o bot desejado, clique no ícone de quebra-cabeça no canto superior direito (abaixo de seu nome de usuário) e em seguida clique em RD Station. A seguinte tela será apresentada:

Clique no botão Instalar. Após isso, um pop-up será aberto com a página do RD Station. Neste momento, entre com suas credenciais do RD Station, escolha a conta que deseja se conectar e clique em Continuar.

Leia as permissões solicitadas pelo aplicativo e clique em Conectar.

Após o término da instalação, a seguinte página será exibida, contendo o nome da sua conta do RD Station e o id do bot conectado.

2. Utilizando a Integração

A integração com o RD Station funciona através de ações no fluxo do seu bot ou através de comandos (HTTP ou SDK). Esta integração permite que você crie leads com dados detalhados do seu cliente.

Ações do Bot

No builder, acesse o bloco do seu fluxo em que deseja criar um lead. Clique em Ações e em seguida clique em + Adicionar ação de entrada/saída. Selecione a opção Registro de eventos. Em Categoria preencha com o valor lead, e em Ação preencha com o valor create. Rótulo e Valor não precisam ser preenchidos.

Os dados do seu cliente devem ser adicionados como informações extras da ação.

Clique em + Adicionar informações extras para cada informação que você deseja enviar para o RD Station. Em Key preencha com o nome do dado, e em Value preencha com a valor do dado (você também pode usar variáveis do fluxo). As informações extras da ação devem ter pelo menos dois campos obrigatórios: conversion_identifier e email. Se algum destes não estiver definido, o lead não será salvo.

Nota:

• Quando o lead é gerado por um evento no builder os campos personalizados #stateId, #messageId e #stateName são gerados automaticamente.

Comandos

Para criar novas conversões de leads na sua conta RDStation, você deve mandar um comando de tipo event-track, com os campos category: "lead" e action: "create". O comando deve ter pelo menos dois campos que são obrigatórios: conversion_identifier e email. Se algum destes não estiver definido, o lead não será salvo.

Exemplo: Requisição HTTP realizada para salvar a conversão:

POST https://http.msging.net/commands HTTP/1.1
Authorization: Key YOUR-BLIP-API-KEY
HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": "9494447a-2581-4597-be6a-a5dff33af156",
    "to": "postmaster@analytics.msging.net",
    "method": "set",
    "type": "application/vnd.iris.eventTrack+json",
    "uri": "/event-track",
    "resource": {
        "category": "lead",
        "action": "create",
        "extras": {
            "conversion_identifier": "9494447a-2581-4597-be6a-a5dff33af156",
            "email": "joao.silva@email.com",
            "step": "Pagamento",
            "conversion_time": "2020-12-04 18:45:12 +00:00"
        }
    }
}

Notas:

• Não inserir Keys repetidas em um mesmo comando ou ação. Caso isto aconteça a segunda ocorrência da Key será ignorada assim como o seu respectivo Value;
• O nome das Keys devem seguir as seguintes regras: Usar caracteres alfanuméricos e/ou underline, não usar caracteres especiais e usar no máximo 64 caracteres;
• Caso você digite o nome de um campo que não exista no RD Station, o BLiP irá criá-los automaticamente.
• Após a criação de um campo personalizado no BLiP, a RD Station garante que ele estará disponivel para uso em até 3 horas. Caso o seu lead não exiba o campo personalizado, aguarde este período e tente novamente.
• Apenas campos do tipo string são suportados pelo BLiP. Portanto as keys tags e available_for_mailing não são suportadas.
• Para mais detalhes dos campos suportados acesse: https://developers.rdstation.com/pt-BR/reference/events#events-post