> ## Documentation Index
> Fetch the complete documentation index at: https://docs.connectvets.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrar seu ERP ao Flow

> Passo a passo simples para conectar seu sistema ao Flow

# 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

<CardGroup cols={2}>
  <Card title="Uso Peti9" icon="paw">
    Se sua clínica usa Peti9, abra **Integrações → Peti9 ERP** no Flow e clique em **Configurar**.
  </Card>

  <Card title="Outro ERP" icon="code">
    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.
  </Card>
</CardGroup>

## 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.

<Tip>
  Um **workspace** é o espaço da sua clínica dentro do Flow. Cada clínica possui suas próprias chaves e dados.
</Tip>

## 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.

<Warning>
  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.
</Warning>

## 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](/flow/integration/erp-checklist).

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:

```json theme={null}
{
  "external_id": "cliente-teste-001",
  "name": "Cliente de teste",
  "phone": "+5511999999999",
  "document": "12345678901"
}
```

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](/flow/webhooks).

## Se algo não funcionar

| Situação                                        | O que conferir                                                                                                                  |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| A chave não funciona                            | Verifique se ela foi copiada inteira e se não foi revogada.                                                                     |
| Aparece erro 403                                | Confirme que a chave pertence ao workspace da clínica e possui a permissão necessária.                                          |
| O contato não aparece                           | Confirme nome, telefone e `external_id`; o telefone deve incluir `+55`.                                                         |
| O contato duplicou                              | Garanta que o ERP sempre envie o mesmo `external_id` para a mesma pessoa.                                                       |
| O responsável técnico não sabe por onde começar | Envie o [checklist de homologação](/flow/integration/erp-checklist) e a [referência de contatos](/flow/api-reference/contacts). |

## Recursos para o responsável técnico

* [Início rápido técnico](/flow/quickstart)
* [Autenticação](/flow/authentication)
* [Contatos](/flow/api-reference/contacts)
* [Política de sincronização](/flow/api-reference/sync-policy)
* [Pesquisa de satisfação](/flow/api-reference/satisfaction-surveys)
* [Webhooks](/flow/webhooks)