# Integrações & API

> D4Sign, Resend, Pulse CRM, TEF e tokens de acesso à API pública da clínica.

Tela exclusiva do **dono da conta** para cadastrar e gerenciar as credenciais dos
serviços externos: **D4Sign** (assinatura digital), **Resend** (e-mails),
**Pulse CRM** (WhatsApp) e **TEF** (maquininhas). Cada serviço aparece com
status (**Conectado / Inativo / Pendente**) e um botão **Configurar**. No rodapé
da página ficam os **tokens de acesso à API pública** (`/api/v1`) para integrações
de terceiros.

_[Tela: Tela de Integrações com lista de serviços e painel de API pública]_

## Configurar uma integração

### Abra o formulário do serviço

Clique em **Configurar** na linha do serviço desejado.

### Cole a chave de API

Informe o **token/API Key** fornecido pelo serviço. O campo abre vazio mesmo
quando já há uma chave salva — em branco mantém; digitar substitui.

### Preencha os campos extras

Cada serviço tem campos específicos:

- **D4Sign** — ID do Cofre, ID do Template de assinatura e e-mail do representante. Veja [contratos em assinatura](/vector/configuracoes/modelos).
- **Resend** — remetente padrão de e-mail.
- **Pulse CRM** — Channel ID e Token do Webhook. Veja [integração Pulse](/vector/configuracoes/pulse).
- **TEF** — apenas liga/desliga global; credenciais e PDVs ficam em [Adquirentes](/vector/configuracoes/unidades-locais-equipamentos).

### Configure o webhook (D4Sign e Pulse)

Clique em **Gerar** no campo **Token do Webhook** (ou cole um próprio). Após
salvar, copie a **URL do Webhook** exibida e cole no painel do serviço externo
(D4Sign: Opções do cofre › Webhook; Pulse/WTS: Configurações › Webhooks). Cada
clínica tem token próprio — o webhook só aceita retornos da própria clínica.

### Teste e salve

No **Pulse**, preencha **Enviar teste para** com um número válido
(ex.: `5511999999999`) e clique em **Testar**. Nos demais serviços o teste
valida a chave de forma leve. Clique em **Salvar** — a linha passa a
**Conectado**.

## Ligar, desligar e remover

- **Chave Ativa** na linha do serviço pausa o uso mantendo as credenciais
  (status **Inativo**). Religar retoma sem redigitar a chave.
- Para apagar as credenciais: abra **Configurar**, clique em **Remover**
  (rodapé em vermelho) e confirme. A integração pode ser reconfigurada depois.

> 
  Desligar ou remover uma integração afeta a clínica inteira imediatamente:
  D4Sign → contratos param; Pulse → WhatsApp/alertas param; Resend → e-mails param.

## API pública — tokens de acesso

O bloco **Chaves da API** no rodapé da página permite criar tokens para sistemas
externos acessarem a clínica via `/api/v1`.

### Gere um novo token

Clique em **Gerar token**, informe um **Nome** que identifique o uso
(ex.: "Integração CRM"), marque as **Permissões (escopos)** necessárias e
defina a **Validade** (sem expiração ou 30/90/180 dias / 1 ano).

### Copie o token na hora

Na tela **Token criado**, clique em **Copiar** e guarde o token em local
seguro. Ele é exibido **uma única vez** — o sistema armazena apenas um hash e
não consegue exibi-lo novamente.

### Use o token nas requisições

Envie o cabeçalho `Authorization: Bearer <token>` em cada chamada à API. Os
endpoints disponíveis dependem dos escopos marcados.

> 
  Marque **só os escopos necessários** (menor privilégio). Para revogar o
  acesso de um token, use **Revogar** na lista — operação definitiva que derruba
  a integração na hora. Se perder o token, crie um novo e revogue o antigo.

## Dúvidas comuns

**Por que o campo da chave abre vazio se já configurei?**
Por segurança, a chave nunca é devolvida pelo servidor. Deixar em branco mantém
o valor salvo; digitar substitui.

**Diferença entre desligar (Ativa) e Remover?**
Desligar pausa o uso mantendo as credenciais (reversível). Remover apaga tudo
e é irreversível.

**O TEF não tem campos de chave — está certo?**
Sim. Aqui é apenas o liga/desliga global. Credenciais e PDVs ficam em
[Adquirentes](/vector/configuracoes/unidades-locais-equipamentos).

**Perdi a chave da API pública — como recupero?**
Não é possível recuperar. Revogue o token antigo e gere um novo.