Integração com o Brevo

Conectar o Brevo a um quiz cria ou atualiza um contato em uma lista do Brevo sempre que o quiz é enviado. Esta página documenta o que é sincronizado por padrão, os atributos de contato que o FluoTest cria na conta do Brevo e como o mapeamento de campos muda o que é enviado.

Última atualização

O que acontece quando conecto o Brevo a um quiz?

O FluoTest cria 4 atributos de contato personalizados na conta do Brevo (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) e, a cada resposta enviada, cria ou atualiza um contato do Brevo pelo e-mail com o nome do respondente e esses atributos de pontuação, ou com os campos mapeados, se o mapeamento de campos estiver configurado.

Configuração#

Uma integração com o Brevo é configurada com uma chave de API da conta do Brevo (Account settings → API Keys), um ID de lista do Brevo opcional para onde adicionar os contatos e uma faixa de pontuação opcional que limita quais respondentes são sincronizados. A chave de API é armazenada no servidor.

Atributos criados automaticamente#

Conectar uma chave de API do Brevo cria os seguintes atributos de contato personalizados na conta do Brevo, se eles ainda não existirem. Isso acontece uma vez, quando a chave é conectada. Os atributos então aparecem na interface de contatos do Brevo antes mesmo de qualquer quiz ser enviado.

AtributoTipoDescrição
FLUOTEST_SCOREfloatA pontuação total do respondente.
FLUOTEST_MAX_SCOREfloatA pontuação máxima possível do quiz.
FLUOTEST_SCORE_PERCENTfloatA pontuação expressa como percentual.
FLUOTEST_QUIZtextO nome do quiz de onde o contato veio.

Campos sincronizados por padrão (sem mapeamento de campos)#

Sem mapeamento de campos configurado, cada resposta enviada cria ou atualiza um contato do Brevo usando o e-mail do respondente como identificador (contatos existentes com esse e-mail são atualizados em vez de gerar um erro) e envia os seguintes atributos:

CampoOrigem
FIRSTNAMENome do respondente, ou o nome completo se nome e sobrenome não foram coletados separadamente.
LASTNAMESobrenome do respondente, se coletado.
FLUOTEST_SCOREPontuação total.
FLUOTEST_MAX_SCOREPontuação máxima possível.
FLUOTEST_SCORE_PERCENTPercentual da pontuação.
FLUOTEST_QUIZNome do quiz.

Campos sincronizados com mapeamento de campos#

Se o mapeamento de campos estiver configurado para a integração com o Brevo (veja Mapeamento de campos e novas tentativas de sincronização), o campo EMAIL mapeado é usado como identificador do contato em vez do e-mail do respondente, e todos os outros campos mapeados são enviados como atributos do Brevo no lugar dos 4 campos padrão acima. O esquema de destino oferecido para o mapeamento é lido em tempo real dos atributos de contato da conta do Brevo, então atributos personalizados já criados no Brevo ficam disponíveis como destinos de mapeamento.

Escolha da lista#

Um ID de lista definido no quiz substitui a lista padrão definida na conta, então quizzes diferentes conectados à mesma conta do Brevo podem adicionar contatos a listas diferentes.

Erros de autorização de IP#

Se a conta do Brevo tiver "Authorised IPs" ativado em Security, o Brevo rejeita as requisições de sincronização, porque os servidores do FluoTest usam endereços IP rotativos que não podem ser adicionados a uma lista fixa de permissões. Essa falha é tratada como permanente e não é repetida. Remover a restrição de IP no Brevo (Security → Authorised IPs) resolve o problema.

Perguntas frequentes#

Conectar o Brevo cria novos campos na minha conta do Brevo?

Sim. Conectar uma chave de API do Brevo cria 4 atributos de contato personalizados (FLUOTEST_SCORE, FLUOTEST_MAX_SCORE, FLUOTEST_SCORE_PERCENT, FLUOTEST_QUIZ) na conta do Brevo, se eles ainda não existirem.

Qual endereço de e-mail é usado para criar o contato no Brevo?

O e-mail do respondente, por padrão, ou o campo mapeado para o destino EMAIL do Brevo, se o mapeamento de campos estiver configurado.

Por que minhas sincronizações com o Brevo falham com um erro de autorização de IP?

Isso acontece quando a conta do Brevo tem restrições de IP ativadas em Security → Authorised IPs. Os servidores do FluoTest usam IPs rotativos que não podem ser liberados, então a restrição precisa ser removida para a sincronização funcionar.

Posso controlar quais respondentes são sincronizados com o Brevo?

Sim. Uma integração com o Brevo pode ser limitada a uma faixa de pontuação específica, para que só os respondentes dessa faixa sejam sincronizados.