Skip to main content

​
Integrar seu ERP ao Flow

Este guia é para quem usa um ERP na clínica e quer manter os contatos organizados também no Flow. Você não precisa ser desenvolvedor para seguir os passos de preparação. Para configurar o seu sistema, envie este guia para a pessoa ou empresa responsável pelo ERP.

​
Escolha o seu caminho

Uso Peti9

Se sua clínica usa Peti9, abra Integrações → Peti9 ERP no Flow e clique em Configurar.

Outro ERP

Peça ao responsável técnico pelo seu ERP para usar a API externa do Flow. Os passos abaixo mostram como liberar o acesso.

​
Antes de começar

Você precisa ser administrador do workspace da clínica no Flow e ter:
  • acesso ao menu Integrações;
  • o nome do ERP que será conectado;
  • alguém responsável pelo ERP, caso ele não seja Peti9;
  • um ambiente de testes do ERP, se ele tiver um.
Um workspace é o espaço da sua clínica dentro do Flow. Cada clínica possui suas próprias chaves e dados.

​
Passo 1: abra as integrações

  1. Entre no Flow.
  2. No menu lateral, clique em Integrações.
  3. Abra a aba Acesso à API.
Você verá uma explicação curta do processo e o botão para gerenciar as chaves da API.

​
Passo 2: crie uma chave de acesso

  1. Clique em Gerenciar chaves.
  2. Clique em criar uma nova chave.
  3. Dê um nome fácil de reconhecer, por exemplo ERP Clínica Centro - produção.
  4. Marque as permissões:
    • contacts:write para criar e atualizar contatos;
    • contacts:read se o ERP também precisa consultar contatos;
    • contacts:delete somente se o ERP deve apagar contatos;
    • satisfaction:write se o ERP avisará quando um atendimento terminar.
  5. Copie a chave exibida na tela e guarde-a em um cofre de senhas.
A chave aparece uma única vez. Não envie a chave por WhatsApp, e-mail, print, planilha ou repositório de código. Se ela vazar, revogue-a e crie outra.

​
Passo 3: envie estas informações ao responsável pelo ERP

Envie:
  • a URL da API: https://api.connectvets.com.br/flow/v1;
  • a chave criada no passo anterior;
  • o nome da clínica/workspace;
  • o link desta página;
  • o checklist de homologação.
O responsável técnico deve primeiro chamar GET /external/me para descobrir o workspace_id correto. Depois, ele poderá criar ou atualizar um contato.

​
Passo 4: faça um teste simples

Peça para o responsável pelo ERP enviar um contato de teste, por exemplo:
Depois, abra Contatos no Flow e procure por “Cliente de teste”. Se o contato aparecer, a primeira parte da integração está pronta.

​
O que acontece depois

  • Quando o ERP cria ou altera um contato, o Flow mantém o cadastro da clínica atualizado.
  • O campo external_id é o código do cliente dentro do seu ERP. Ele permite atualizar a mesma pessoa sem criar duplicatas.
  • A clínica pode escolher se o nome e telefone são controlados pelo Flow ou pelo ERP em Integrações → Acesso à API.
  • O Flow pode avisar o ERP quando contatos ou etapas de lead mudarem usando webhooks.

​
Se algo não funcionar

​
Recursos para o responsável técnico