# Sábio Adv API

> API REST para integrar WhatsApp oficial (Meta Cloud API), CRM jurídico, leads e funis da plataforma Sábio Adv — usada por escritórios de advocacia brasileiros para automatizar atendimento e qualificação de leads.

## Documentação

- [Referência interativa](https://plataforma.sabioadv.com.br/api-docs): documentação completa com playground "Try it" para testar endpoints ao vivo.
- [MCP Server (Claude, Cursor, ChatGPT Desktop)](https://plataforma.sabioadv.com.br/api-docs/mcp): servidor Model Context Protocol oficial — 10 tools nativas para qualquer cliente MCP. URL: `https://oavhtlipjwctndgqdtdd.supabase.co/functions/v1/mcp-server`, auth Bearer com a mesma api_key das APIs REST.
- [Documentação completa em Markdown (llms-full)](https://plataforma.sabioadv.com.br/llms-full.txt): toda a API em um único Markdown otimizado para LLMs.
- [OpenAPI 3.1 Spec](https://plataforma.sabioadv.com.br/openapi.json): especificação machine-readable.
- [Glossário](https://plataforma.sabioadv.com.br/api-docs/glossario): termos canônicos (WABA, janela 24h, template, funil, tag).
- [Site institucional](https://sabioadv.com.br): visão geral do produto.

## Endpoints públicos

Todos exigem header `Authorization: Bearer <API_KEY>`. A API key é gerada em **Conta → API** na plataforma.

- [POST /functions/v1/send-message-api](https://plataforma.sabioadv.com.br/api-docs/send-message): Envia mensagem WhatsApp (texto livre, template Meta oficial, ou lista templates aprovados). Fallback automático para Uazapi quando janela 24h expira.
- [POST /functions/v1/create-lead-api](https://plataforma.sabioadv.com.br/api-docs/create-lead): Cria lead no CRM com tags, descrição, agendamento e coluna de funil. Merge automático por telefone.
- [POST /functions/v1/update-contact-name](https://plataforma.sabioadv.com.br/api-docs/update-contact-name): Atualiza o nome de um contato/lead existente identificado por telefone.
- [POST /functions/v1/get-funnels-api](https://plataforma.sabioadv.com.br/api-docs/get-funnels): Lista funis e colunas da empresa para movimentar leads programaticamente.
- [POST /functions/v1/list-leads-api](https://plataforma.sabioadv.com.br/api-docs/list-leads): Lista leads do CRM com paginação, filtros por coluna/status e busca textual; retorna tags vinculadas.
- [POST /functions/v1/get-lead-api](https://plataforma.sabioadv.com.br/api-docs/get-lead): Retorna lead completo (com tags e agendamentos) por lead_id ou telefone.
- [POST /functions/v1/list-tags-api](https://plataforma.sabioadv.com.br/api-docs/list-tags): Lista todas as tags (company_tags) da empresa.
- [POST /functions/v1/list-conversations-api](https://plataforma.sabioadv.com.br/api-docs/list-conversations): Lista mensagens WhatsApp (Meta + Uazapi) trocadas com um contato, por telefone ou lead_id.
- [POST /functions/v1/add-tag-to-lead-api](https://plataforma.sabioadv.com.br/api-docs/add-tag-to-lead): Vincula uma tag (UUID ou nome) a um lead; cria a tag se necessário; idempotente.
- [POST /functions/v1/move-lead-column-api](https://plataforma.sabioadv.com.br/api-docs/move-lead-column): Move um lead entre colunas do funil, validando ownership por empresa.

## Casos de uso

- Integração com formulários de captura (Hotmart, RD Station, Typeform).
- Sincronização com CRMs externos (HubSpot, Pipedrive, AdvBox).
- Agentes de IA (ChatGPT, Claude, n8n, Make) respondendo WhatsApp do escritório.
- Disparos controlados de templates oficiais Meta para reativação de leads frios.

## Autenticação e limites

- Bearer token único por usuário, resolve automaticamente WABA, phone_number_id e empresa.
- Sem rate limit hard — sujeito ao saldo de mensagens da assinatura (R$ 997 base + R$ 1 por processo monitorado).
- Mensagens persistidas no Multiatendimento para visibilidade total no CRM.

## Optional

- [Status da plataforma](https://sabioadv.com.br): informações públicas sobre o produto.