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.
| Atributo | Tipo | Descrição |
|---|---|---|
| FLUOTEST_SCORE | float | A pontuação total do respondente. |
| FLUOTEST_MAX_SCORE | float | A pontuação máxima possível do quiz. |
| FLUOTEST_SCORE_PERCENT | float | A pontuação expressa como percentual. |
| FLUOTEST_QUIZ | text | O 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:
| Campo | Origem |
|---|---|
| FIRSTNAME | Nome do respondente, ou o nome completo se nome e sobrenome não foram coletados separadamente. |
| LASTNAME | Sobrenome do respondente, se coletado. |
| FLUOTEST_SCORE | Pontuação total. |
| FLUOTEST_MAX_SCORE | Pontuação máxima possível. |
| FLUOTEST_SCORE_PERCENT | Percentual da pontuação. |
| FLUOTEST_QUIZ | Nome 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.