RECURSO DE API

Lead & CRM

Reúna as solicitações recebidas (leads) em um único pool; acompanhe tarefas, chamadas e a comunicação com o paciente. Que nenhum interesse se perca pelo caminho.

Acesso Antecipado Toda a API

Endpoints

7 endpoint

Endpoints deste recurso. Cada endpoint é limitado aos dados da clínica à qual a chave de API está vinculada; os endpoints de gravação suportam o cabeçalho Idempotency-Key.

GET /v1/leads Lista os leads/solicitações Usuário autorizado

POST /v1/leads Cria um novo lead Usuário autorizado

POST /v1/leads/{id}/status Altera o status/etapa do lead Usuário autorizado

GET /v1/tasks Lista as tarefas Usuário autorizado

POST /v1/tasks Cria uma tarefa Usuário autorizado

GET /v1/messages Lista as mensagens de comunicação do paciente Usuário autorizado

POST /v1/messages Cria um registro de mensagem/comunicação Usuário autorizado

Exemplo de Uso

Atualizar o status do lead

Requisição

curl -X POST https://api.udentiva.com/v1/leads/{id}/status \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"status":"qualified"}'

Resposta

HTTP/1.1 200 OK
{
  "id": "ld-88",
  "status": "qualified"
}

Segurança neste recurso

Segurança não é um recurso, é a própria arquitetura. As garantias que se aplicam a este recurso:

Os registros de lead e de comunicação são isolados à sua clínica (RLS).

A recepção pública de leads (landing) é um endpoint separado, sem sessão e com limite de taxa; o spam é bloqueado com o limite de janela do Redis.

Todo o modelo de segurança →

Formato de Erro

Os erros retornam em um envelope consistente; o código é destinado à máquina, a mensagem ao usuário. Erro interno/stack nunca é vazado.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo inválido: e-mail"
  }
}

Outros Recursos

Pacientes Agendamentos e calendário Odontograma & Tratamento Cobrança e Finanças Estoque Imagem Laboratório Turismo de saúde Relatórios & BI Webhooks Transferência de Dados (Export API)

Deseja acesso antecipado?

Seja o primeiro a saber quando a API for lançada.

Entre em Contato