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.
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.
- Resend — remetente padrão de e-mail.
- Pulse CRM — Channel ID e Token do Webhook. Veja integração Pulse.
- TEF — apenas liga/desliga global; credenciais e PDVs ficam em Adquirentes.
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.
Perdi a chave da API pública — como recupero? Não é possível recuperar. Revogue o token antigo e gere um novo.