agenciafmd/laravel-rdstation

Integração com a RD Station

dev-master 2024-09-03 12:18 UTC

This package is auto-updated.

Last update: 2024-11-03 12:38:36 UTC


README

Downloads Licença

  • Envia as conversões para o RD Station

Instalação

composer require agenciafmd/laravel-rdstation:dev-master

Configuração V1

Para que a integração seja realizada, precisamos do token público

Para isso, vamos em Perfil > Integrações

Perfil > Integrações

Agora, vamos em Dados da Integração > Token Público

Dados da Integração > Token Público

Colocamos esta chave no nosso .env

RDSTATION_PUBLIC_KEY=VYfa6Oo1oaCIeQ68Ase9dSOBPdgRvWtJ

Uso

Envie os campos no formato de array para o SendConversionsToRdstation.

O campo email é obrigatório =)

Para que o processo funcione pelos jobs, é preciso passar os valores dos cookies conforme mostrado abaixo.

use Agenciafmd\Rdstation\Jobs\SendConversionsToRdstation;

$data['email'] = 'irineu@fmd.ag';
$data['nome'] = 'Irineu Junior';

SendConversionsToRdstation::dispatch($data + [
        'identificador' => 'seja-um-parceiro',
        'utm_campaign' => Cookie::get('utm_campaign', ''),
        'utm_content' => Cookie::get('utm_content', ''),
        'utm_medium' => Cookie::get('utm_medium', ''),
        'utm_source' => Cookie::get('utm_source', ''),
        'utm_term' => Cookie::get('utm_term', ''),
        'gclid_' => Cookie::get('gclid', ''),
        'cid' => Cookie::get('cid', ''),
    ])
    ->delay(5)
    ->onQueue('low');

Configuração V2

Antes de começarmos, é preciso solicitar a criação de uma conta para o desenvolvedor responsável na RD Station.

Com a conta criada, vamos criar o aplicativo

Vá em https://developers.rdstation.com/

Faça seu login e escolha o cliente (caso possua mais de um) e clique em Acessar RD Station Marketing

docs/acessar-rd-station-marketing.png

No menu Produtos, clique em RD Station App Store

docs/acessar-rd-station-app-store.png

Agora, vamos em Meus Apps > Criar um aplicativo

Escolhemos um nome bem intuitivo e clicamos em Criar App

docs/criar-app.png

Agora é só seguir os passos.

Atenção para a URL de redirecionamento, ela é importante para a autenticação.

É a partir dela, que vamos conseguir recuperar o code

docs/criar-app-redirect.png

Após a criação, copiamos o Client ID e o Client Secret

docs/client-secret-callback.png

Para conseguirmos o code, vamos trocar o client_id e o redirect_uri com os dados que recuperamos do nosso app.

https://api.rd.services/auth/dialog?client_id=client_id&redirect_uri=redirect_uri&state=

Se tudo correr bem, seremos redirecionado para a url de callback que inserimos no nosso app.

Vamos agora, copiar o code da url.

docs/code.png

Agora vamos recuperar o access_token e o refresh_token.

Para isso, vamos fazer uma requisição POST para o endpoint /auth/token?token_by=code

No exemplo abaixo, vamos trocar o client_id, client_secret e code pelos valores que recuperamos do nosso app.

curl --request POST \
     --url 'https://api.rd.services/auth/token?token_by=code' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "client_id": "client_id",
  "client_secret": "client_secret",
  "code": "code"
}
'

Algo muito semelhante a isso será retornado (note que comemos um bom pedaço dos dados).

{
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9...",
    "expires_in": 86400,
    "refresh_token": "1-GZ7PR4V5tsS..."
}

Agora tem conseguimos todos os dados necessários para a configuração.

RDSTATION_CLIENT_ID=71d41aa9-5967-4820-aad1-9da1e753d2d1
RDSTATION_CLIENT_SECRET=a140c4683eca43d092fc2837c4efdf46
RDSTATION_REFRESH_TOKEN=1-WX7PR4V5cvSaX9K-9qvcCQm8fPOkhWSM5i6fuTkYY

Uso

Envie os campos no formato de array para o SendConversionsToRdstationV2.

O campo email é obrigatório =)

Para que o processo funcione pelos jobs, é preciso passar os valores dos cookies conforme mostrado abaixo.

Note que os campos cf_assunto_de_interesse e cf_empreendimento são campos customizados que criamos no RD Station e podem variar de acordo com cada cliente.

use Agenciafmd\Rdstation\Jobs\SendConversionsToRdstationV2;

$data['email'] = 'irineu@fmd.ag';
$data['nome'] = 'Irineu Junior';

SendConversionsToRdstationV2::dispatch($data + [
        'conversion_identifier' => 'seja-um-parceiro',
        'mobile_phone' => $data['phone'],
        'cf_assunto_de_interesse' => 'assunto',
        'cf_empreendimento' => 'nome-do-empreendimento',
        'cf_utm_campaign' => Cookie::get('utm_campaign', ''),
        'cf_utm_content' => Cookie::get('utm_content', ''),
        'cf_utm_medium' => Cookie::get('utm_medium', ''),
        'cf_utm_source' => Cookie::get('utm_source', ''),
        'gclid_' => Cookie::get('gclid', ''),
        'cid' => Cookie::get('cid', ''),
        // seria legal matar esses campos
        'traffic_source' => Cookie::get('utm_source', ''),
        'traffic_medium' => Cookie::get('utm_medium', ''),
        'traffic_campaign' => Cookie::get('utm_campaign', ''),
        'traffic_value' => Cookie::get('utm_content', ''),
        'client_tracking_id' => Cookie::get('cid', '') . '|' . Cookie::get('gclid', ''),
        // fim do seria legal matar esses campos
    ])
    ->delay(5)
    ->onQueue('low');

Queue

Note que nos nossos exemplos, enviamos o job para a fila low.

Certifique-se de estar rodando no seu queue:work esteja semelhante ao abaixo.

php artisan queue:work --tries=3 --delay=5 --timeout=60 --queue=high,default,low