1) Sobre a integração
A integração entre Ploomes e Flowbiz conecta o CRM às ferramentas de automação de marketing, permitindo sincronizar cadastros de clientes, empresas e campos personalizados entre as plataformas.
O objetivo é centralizar os dados de clientes, automatizar campanhas e garantir que alterações feitas no Ploomes sejam refletidas no Flowbiz em tempo real — sem necessidade de exportações manuais de listas.
2) Pré-requisitos
Antes de ativar a integração, certifique-se de:
Ter um usuário administrador no Ploomes.
Possuir uma conta ativa no Flowbiz com acesso à API Key.
⚠️ Contatos sem e-mail não são sincronizados.
3) Como ativar a integração
Acesse Configurações > Integrações > Flowbiz no Ploomes.
Clique em "Habilitar integração" e depois “Autorizar integração”.
Vá até o Flowbiz para gerar sua Chave de API.
Para isso, vá até o nome do usuário no menu superior direito e selecione "Chaves de API".
Clique em "Criar chave de API" e coloque o nome da chave de API. Não insira nenhum IP no campo abaixo.
Copie a chave, cole na aba de autorização e clique em continuar.
Clique em "Ativar a integração". Não é possível mapear campos antes da primeira ativação da integração.
O sistema verifica se já existe uma lista padrão chamada
Clientes Ploomes - {AccountID}no Flowbiz. Se existir, ela será reutilizada. Se não existir, uma nova lista será criada automaticamente.
Durante essa etapa, os campos fixos são criados no Flowbiz e são mapeados com os do Ploomes.
Agora você pode mapear seus campos que serão integrados ao Flowbiz!
4) Casos de uso da integração
4.1 Segmentação automática com base em campos do Ploomes
É possível configurar segmentos dentro do Flowbiz a partir dos campos mapeados na integração com o Ploomes. Assim, quando um contato recebe uma nova propriedade no Ploomes (por exemplo, um marcador ou status específico), ele pode automaticamente entrar em um segmento do Flowbiz. A partir dessa segmentação, o contato pode ser adicionado a uma campanha ou sequência de e-mails, de forma dinâmica e automatizada.
4.2) Leads provenientes de formulários no Flowbiz
Quando um lead preenche um formulário em uma landing page criada no Flowbiz, ele é incluído automaticamente na lista padrão vinculada à integração. Na próxima sincronização programada, esse lead é criado como contato no Ploomes e, caso a empresa informada ainda não exista, ela é criada e vinculada automaticamente.
4.3) Consulta de interações de campanha
Também é possível consultar, diretamente a partir do Ploomes, os eventos de interação dos contatos com as campanhas enviadas pelo Flowbiz. Para acessar essas informações, basta abrir a página do contato e clicar na aba Flowbiz, onde são exibidos os eventos registrados no histórico de interações.
5) Como funciona
A integração é bidirecional e combina dois mecanismos complementares: o envio de webhooks e as consultas periódicas. Quando ocorre qualquer atualização no Ploomes, o sistema envia um webhook em tempo real para o Flowbiz, garantindo que as informações fiquem atualizadas imediatamente. Além disso, a cada hora o Ploomes realiza uma verificação no Flowbiz para identificar alterações recentes e sincronizar eventuais diferenças de dados.
5.1) Ploomes → Flowbiz
Gatilho: Criação, atualização ou exclusão de um contato no Ploomes.
Mecanismo: Webhook automático enviado sempre que há uma modificação em algum dos campos mapeados.
Regras principais:
Se o contato tiver ID Flowbiz, o contato referente no Flowbiz é atualizado.
Se não tiver, é feita uma busca por e-mail.
Se o e-mail existir, atualiza o registro existente e retorna o ID Flowbiz.
Se não existir, cria um novo contato no Flowbiz e preenche as informações vindas do Ploomes.
Campos sincronizados: Nome, E-mail, Telefone, Empresa, Marcadores e campos personalizados mapeados.
Casos especiais:
Alterações de e-mail no Ploomes atualizam o e-mail no Flowbiz.
Contatos com múltiplos e-mails (separados por ponto e vírgula) enviam apenas o primeiro.
Se o e-mail for apagado no Ploomes, o contato é removido da lista Flowbiz correspondente.
5.2) Flowbiz → Ploomes
Gatilho: Consulta automática realizada pelo Ploomes a cada hora.
Mecanismo: O sistema verifica os registros no Flowbiz e identifica aqueles que foram modificados após a última sincronização.
Regras principais:
Apenas registros com data de última modificação posterior à registrada no Ploomes são atualizados.
Atualiza contatos existentes no Ploomes com base no ID Flowbiz.
Se o contato não existir, cria um novo contato no Ploomes.
Empresas:
Se o contato vier com empresa preenchida:
Verifica duplicidade por CNPJ e por Nome da empresa.
Se não existir, cria nova empresa e vincula o contato.
Casos especiais:
Se o Flowbiz devolver um campo vazio que estava preenchido no Ploomes, ele é limpo no Ploomes.
Descadastros no Flowbiz não removem o contato.
Se um contato for apagado no Flowbiz, a deleção não é refletida no Ploomes. Para apagar um contato, é necessário deletá-lo no Ploomes.
5.4) Compatibilização de campos
Ao ativar ou atualizar a integração, as opções pré-cadastradas dos campos mapeados são sincronizadas. Quando há campos de opções (como listas ou seletores), o Ploomes cria automaticamente as opções correspondentes no Flowbiz. Caso alguma opção não exista, ela é criada durante a atualização da integração. Problemas com opções faltando ou divergentes no Flowbiz geralmente são resolvidos ao atualizar a integração.
5.5) Histórico de atividades
A consulta às atividades do Flowbiz pode ser feita através da aba "Flowbiz" na timeline do contato no Ploomes e é feita via e-mail, exibindo aberturas, bounces e interações associadas às campanhas enviadas.
5.6) Cenários de duplicidade e integridade
Cenário | Ação |
Mesmo e-mail em listas diferentes | O e-mail é tratado como chave global; alterações impactam todas as listas |
E-mails duplicados na mesma lista | Retorna erro e o registro é ignorado |
Contato sem e-mail no Ploomes | Ignorado pela sincronização |
Alteração de e-mail existente | Atualiza registros nas duas plataformas |
Descadastro (unsubscribe) no Flowbiz | Mantém contato no Ploomes e ainda existe no Flowbiz |
Exclusão no Flowbiz | A deleção não é refletida no Ploomes. Para apagar um contato, é necessário deletá-lo no Ploomes |
6) FAQ
6.1) A integração é automática ou precisa ser atualizada manualmente?
A sincronização é automática. O Ploomes envia webhooks em tempo real para o Flowbiz e realiza consultas de hora em hora para capturar alterações recentes feitas no Flowbiz.
6.2) O que acontece se eu editar o e-mail de um contato no Ploomes?
O Flowbiz é atualizado imediatamente via webhook. Se o e-mail já existir em outra lista, a atualização pode gerar um conflito, e o registro será tratado conforme as regras de duplicidade.
6.3) Posso criar campanhas automáticas no Flowbiz baseadas em informações do Ploomes?
Sim. Campos mapeados podem ser usados para criar segmentos dinâmicos, que alimentam campanhas e sequências de e-mails automaticamente.
6.4) Leads capturados por formulários no Flowbiz aparecem no Ploomes?
Sim. Após a próxima sincronização, o lead é criado no Ploomes junto com sua empresa, caso ainda não exista.
6.5) Onde vejo as interações de campanhas no Ploomes?
Na página do contato, na aba Flowbiz, onde ficam listados os eventos de interação recebidos do Flowbiz.