A Bonifiq oferece integração com a Flowbiz para atualizar automaticamente o saldo de pontos dos seus clientes. Isso permite personalizar campanhas informando o saldo atual de cada contato, sem precisar atualizar manualmente.
Neste tutorial, você vai aprender como:
-
Criar um campo personalizado para armazenar os pontos
-
Gerar a chave de API
-
Montar a URL de integração
-
Configurar o webhook dentro da Bonifiq
⚠️ Importante: Essa integração não dispara e-mails automaticamente. Ela apenas atualiza os dados no CRM da Flowbiz.
1. Crie o campo personalizado "Pontos" na sua lista
Acesse uma lista na Flowbiz, vá até o menu lateral e clique em Campos Personalizados. Em seguida, clique no botão “Criar novo campo personalizado”.
Preencha os dados conforme a imagem e salve.
Esse campo será usado para armazenar os pontos atualizados de cada contato.
Após salvar, identifique o Field ID do campo criado. Ele será usado na URL do webhook.
2. Copie o ID da lista
Esse ID também será necessário para montar a URL de integração. Você encontra o ID da lista no topo da tela, ao lado do nome da lista.
3. Gere a chave de API na Flowbiz
Clique no seu nome no canto superior direito e acesse a opção Chaves da API.
Clique em “Criar nova chave”, dê um nome de identificação e salve.
Copie e guarde essa chave com segurança, pois ela será usada na URL.
4. Monte a URL de integração
Utilize o modelo abaixo e substitua os valores destacados:
https://mbiz.mailclick.me/api.php/Subscriber.Subscribe?APIKey=SUACHAVEDEAPI&Command=Subscriber.Subscribe&ResponseFormat=JSON&ListID=SEU_ID_DE_LISTA&EmailAddress={{Customer.Email}}&CustomFieldSEU_ID_DE_CAMPO_PERSONALIZADO={{EarnedPoints}}&IPAddress=123456789&UpdateIfExists=true
Exemplo com os valores preenchidos:
https://mbiz.mailclick.me/api.php/Subscriber.Subscribe?APIKey=abc123xyz&Command=Subscriber.Subscribe&ResponseFormat=JSON&ListID=19719&EmailAddress={{Customer.Email}}&CustomField34659={{EarnedPoints}}&IPAddress=34661&UpdateIfExists=true
5. Cadastre o Webhook na Bonifiq
Agora que a URL está pronta, acesse o painel da Bonifiq e vá até o menu API → + Credencial de API → escolha “Webhook”.
Preencha os campos da seguinte forma:
-
Ativado: marque esta opção no topo da tela
-
Nome: Flowbiz
-
URL: cole a URL que você gerou
-
Tópicos: selecione “Ponto Adicionado”
E-mail técnico: preencha com um e-mail válido para alertas
Teste a integração
Você pode testar manualmente a atribuição de pontos na Bonifiq e conferir se o saldo foi atualizado no campo da Flowbiz. O dado será refletido automaticamente no perfil do contato e pode ser usado em campanhas, segmentações e mensagens.
Se tiver dúvidas, fale com o nosso time de suporte.