Sobre o Vértice
O Vértice é uma camada de infraestrutura para operar o WhatsApp: números multi-instância, API REST, webhooks duráveis e um painel multi-tenant. Ele usa o protocolo multi-device via Baileys e não tem vínculo com o WhatsApp ou a Meta.
O que está incluído
Cada workspace tem usuários, números, eventos e chaves próprios. O
isolamento é garantido na API: uma sessão ou chave só acessa as
instâncias do seu workspace. A chave mestra do servidor
(API_KEY) é reservada à operação da plataforma.
- Conexão por QR code ou código de pareamento, com reconexão automática e backoff.
- Envio de texto, mídia e mensagens de voz (PTT), até 25 MB.
- Webhooks assinados com HMAC-SHA256, outbox em disco e retry exponencial.
- Conversas recentes no painel, com histórico local das últimas 1000 mensagens por instância.
- Equipe com papéis (proprietário, administrador, membro) e convites por link.
- Planos com limites de números e usuários e assinatura via Stripe Checkout.
API REST
A base é o mesmo domínio do painel. Todas as respostas de sucesso vêm
em { "data": ... }; erros em
{ "error": { "code", "message" } }.
| Método | Rota | Descrição |
|---|---|---|
| GET | /instances | Lista instâncias do workspace. |
| POST | /instances | Cria instância (name, webhookUrl?). |
| GET | /instances/:id | Detalhe da instância. |
| PATCH | /instances/:id | Atualiza nome e/ou webhook (admin). |
| DELETE | /instances/:id | Remove a instância e a sessão (admin). |
| POST | /instances/:id/connect | Abre o socket; gera QR se não houver sessão. |
| GET | /instances/:id/qr | Status e QR atual (dataUrl). |
| POST | /instances/:id/pair | Pareamento por phoneNumber. |
| POST | /instances/:id/disconnect | Fecha o socket mantendo a sessão. |
| POST | /instances/:id/logout | Desvincula o aparelho e apaga a sessão. |
| POST | /instances/:id/messages | Envia texto (to, text). |
| POST | /instances/:id/media | Envia mídia (kind, url ou base64). |
| POST | /instances/:id/on-whatsapp | Verifica números. |
| GET | /instances/:id/groups | Lista grupos. |
| GET | /instances/:id/chats | Conversas recentes. |
| GET | /instances/:id/chats/messages | Mensagens de uma conversa (jid). |
| GET | /instances/:id/webhook-secret | Revela o segredo HMAC (admin). |
| GET | /instances/:id/webhook-deliveries | Entregas da outbox. |
| POST | /instances/:id/webhook-test | Dispara um evento de teste. |
Referência completa e OpenAPI em /docs. Rotas de workspace: /tenant, /tenant/members, /tenant/invitations, /tenant/api-keys, /billing. Rotas da plataforma: /admin/*.
Autenticação
O painel usa sessão em cookie HttpOnly, com expiração
deslizante e proteção CSRF (header x-csrf-token). As
integrações server-side usam uma chave do workspace:
curl https://seu-dominio/instances \
-H "x-api-key: vtc_live_..."
Também é aceito Authorization: Bearer <chave>. A
chave é exibida apenas uma vez na criação; guarde-a com segurança.
Webhooks
Cada evento é gravado em uma outbox antes da primeira tentativa. O envio é serial por instância, com retry 1 s, 5 s, 30 s, 2 min, 10 min, 30 min, 1 h (repetindo até o prazo configurado).
Headers enviados:
x-webhook-event— nome do evento.x-webhook-id— id do envelope (deduplique por ele).x-webhook-signature—sha256=<hmac>do corpo cru.
event message.received
data { from, sender, text, media, fromMe, timestamp, ... }Planos e limites
O teste inclui 1 número e 3 usuários por 7 dias. Os planos pagos aumentam limites de números, usuários e recursos. Os limites são verificados na criação de instâncias e de convites; instâncias já conectadas continuam ativas em caso de atraso de pagamento.
Termos de uso
Última atualização: outubro de 2026. Este documento é um modelo operacional e não substitui orientação jurídica.
1. Natureza do serviço
O Vértice é um software não oficial de integração com o WhatsApp, fornecido no modelo auto-hospedado. O contratante é responsável pela infraestrutura contratada, pelas credenciais e pelo uso dos números.
2. Risco de banimento
O uso viola os termos da Meta. Não há garantia de disponibilidade do WhatsApp, de manutenção da sessão ou de não banimento. O risco é integralmente do contratante.
3. Contas e pagamentos
Planos pagos são cobrados por workspace até o cancelamento. O cancelamento interrompe a cobrança seguinte; números já conectados permanecem ativos, mas novos números passam a respeitar o limite do plano vigente.
4. Uso aceitável
É proibido spam, assédio, fraude, conteúdo ilegal e uso que viole direitos de terceiros. O acesso pode ser suspenso em caso de abuso.
5. Limitação de responsabilidade
O software é fornecido “como está”, sem garantias implícitas. Na máxima extensão permitida, a responsabilidade total limita-se ao valor pago nos 12 meses anteriores.
Privacidade
Dados tratados
Nome, e-mail, workspace, papel do usuário, metadados das instâncias,
mensagens recentes para o painel e entregas de webhook. Senhas são
armazenadas com scrypt e nunca em texto puro.
Onde ficam
No Postgres do Supabase self-hosted e no armazenamento local da instância (sessões do WhatsApp, mídia em cache e outbox). O contratante controla a infraestrutura e os backups.
Retenção
O painel mantém até 1000 mensagens por instância; mídias recebidas ficam disponíveis por 48 horas. Sessões expiradas são removidas automaticamente. A exclusão do workspace pode ser solicitada ao suporte.
Compartilhamento
Não vendemos dados. O Stripe processa pagamentos; os dados de cartão não passam pelo servidor do Vértice. Webhooks são enviados apenas para as URLs configuradas pelo workspace.
Dúvidas? suporte@vertice.app