A integração com o RD Station Marketing permite enviar dados de clientes para o RD Station quando um pedido atinge um status previamente configurado.
O funcionamento é unidirecional: a Flexy envia informações para o RD Station, mas não realiza a importação ou leitura de contatos, leads ou outras informações do RD Station.
Tecnicamente, a integração utiliza a API de Eventos de Conversão do RD Station Marketing. Portanto, os dados enviados são registrados no RD Station como uma conversão, acompanhados das tags e informações configuradas pela integração.
Onde encontrar
Acesse:
Menu → Configurações → Integração RD Station
Antes de configurar
Para utilizar a integração, é necessário contratar o serviço diretamente com o RD Station e obter a API Key.
A Flexy não gera nem valida essa chave no momento do cadastro. O valor informado é armazenado pela plataforma e a validação ocorre somente quando o sistema tenta realizar um envio para o RD Station.
Importante: não há uma validação de formato da API Key no momento do salvamento. Portanto, uma chave inválida pode ser salva normalmente, e o problema será identificado somente quando houver uma tentativa de envio.
Configurações da integração
A tela possui três configurações:
Habilitado = Ativa ou desativa a integração com o RD Station.
Quando habilitada, o sistema passa a verificar as alterações de status dos pedidos para identificar aqueles que devem gerar um evento de conversão.
API Key = Campo utilizado para informar a chave de API fornecida pelo RD Station.
Essa chave é utilizada para autenticar os envios realizados pela Flexy.
Status do Pedido para realizar integração = Define qual status do pedido deve disparar o envio de informações para o RD Station.
Sempre que um pedido atingir o status configurado, o sistema verifica se a integração está habilitada e, caso esteja, inicia o processo de envio.
Importante: a configuração é global para a conta. Mesmo em contas marketplace, não é possível configurar uma API Key diferente para cada loja por meio desta tela.
Como funciona o envio
Sempre que um pedido muda de status, o sistema verifica:
- Se a integração está habilitada.
- Se o novo status corresponde ao status configurado para a integração.
Quando as duas condições são atendidas, o sistema realiza o envio para o RD Station.
O envio é feito por item do pedido
O evento não é gerado apenas uma vez para o pedido. O processamento ocorre por item do pedido, e cada item pode gerar seu próprio evento de conversão.
Cada item é enviado apenas uma vez
Um mesmo item de pedido só pode gerar o evento de integração uma única vez.
Por isso, se o pedido voltar posteriormente para o status configurado — por exemplo, após uma alteração manual de status — um item que já tenha sido enviado anteriormente não será enviado novamente.
Esse comportamento deve ser considerado principalmente em fluxos nos quais o pedido pode passar mais de uma vez pelo mesmo status.
Ponto de atenção: não há um aviso na tela informando que um item já foi enviado anteriormente. Caso um pedido não apareça completo no RD Station, vale verificar se os itens já tiveram seus eventos processados
Dados enviados ao RD Station
A integração envia informações do cliente e dados adicionais cadastrados na plataforma.
Tag da integração
Todos os eventos recebem a tag fixa:
INTEGRACAO_FLEXY
Dados do cliente
São enviados os seguintes dados:
- Nome — utiliza o campo Responsável cadastrado no cliente.
- Nome da empresa — obtido a partir do CNPJ cadastrado no cliente, quando disponível.
- E-mail.
- Telefone.
-
Campos adicionais cujo código de referência contenha
cf-.
Campos adicionais personalizados
Além dos dados enviados por padrão, é possível enviar informações personalizadas do cadastro do cliente.
Para isso, crie um campo adicional em:
Clientes → Campos Adicionais
O código de referência do campo deve conter cf-.
Por exemplo:
cf-profissao
Depois de criado e preenchido no cadastro do cliente, o campo passa a ser enviado automaticamente nos eventos de conversão, sem necessidade de uma configuração adicional na tela da integração.
Conversão do código do campo
Nos campos adicionais enviados dessa forma, o hífen - do código é convertido em underline _.
Por exemplo:
cf-profissao → cf_profissao
O prefixo cf é mantido.
Importante: o código não precisa começar com
cf-. Basta que contenha essa sequência em qualquer posição.
Campos do tipo Combobox
Para campos adicionais do tipo Combobox, as opções devem ser separadas por ponto e vírgula.
Exemplo:
Consultor(a);Corretor(a);Engenheiro(a)
Consentimento e disponibilidade para e-mail marketing
Todo evento enviado pela integração inclui informações de consentimento e disponibilidade para comunicação de marketing.
Esses valores são definidos fixamente pela integração, sem uma configuração correspondente na tela e sem uma verificação do consentimento individual do cliente antes do envio.
O evento enviado inclui:
-
available_for_mailing: true; - uma declaração de base legal com status de consentimento concedido, na categoria
communications.
Esses valores são enviados para todos os clientes, independentemente de existir ou não um registro real de opt-in, aceite de newsletter ou outro registro de consentimento no cadastro.
Ponto de atenção — LGPD e compliance: como a integração declara esses valores de forma fixa, sem realizar uma checagem do consentimento efetivamente registrado para cada cliente, é importante avaliar o impacto desse comportamento junto às áreas responsáveis por jurídico, privacidade ou compliance antes de habilitar a integração, caso a operação dependa desse consentimento para o tratamento dos dados no RD Station.
Essa regra não é configurável pela tela de integração.
O que acontece quando o envio falha
O envio para o RD Station ocorre de forma assíncrona.
Isso significa que a alteração do status do pedido não fica bloqueada aguardando uma resposta do RD Station.
Caso ocorra uma falha no envio — por exemplo, uma chave inválida ou uma instabilidade no serviço — o sistema realiza novas tentativas automaticamente.
São realizadas até três tentativas, por meio de uma rotina periódica.
Se o envio continuar falhando após a terceira tentativa, um alerta é enviado por e-mail para o time técnico da Flexy, e não para a loja.
Do lado da loja, não há um aviso visível na tela informando a falha.
Importante: se houver suspeita de que um pedido ou algum de seus itens não foi enviado ao RD Station, é necessário abrir um chamado com o suporte para que o processamento possa ser verificado.
Suporte
Caso tenha dúvidas ou precise de apoio para configurar ou validar a integração, entre em contato com o CSM da sua conta ou pelo e-mail suporte@flexy.com.br.
Comentários
0 comentário
Por favor, entre para comentar.