# VENUM > VENUM é a plataforma da Cobra (Tech Provider da Meta) para atendimento, clientes e vendas pelo WhatsApp com a API Oficial (WhatsApp Business Platform). Um só número atendido por toda a equipe, coexistência com o WhatsApp Business do celular, funil de leads, pedidos e faturamento, campanhas com templates, API de Conversões da Meta e inteligência artificial opcional. Feita em Timbó, SC, para empresas de todo o Brasil. Site e produto em português (pt-BR). Contato: WhatsApp +55 47 93618-3868 (https://wa.me/5547936183868) · contato@cobra.art.br · CBR Marketing Ltda, CNPJ 61.986.985/0001-60, Rua Blumenau, 702, Sala 01, Bairro dos Estados, Timbó, SC, CEP 89093-438. Painel do cliente: https://dash.venum.app.br. Toda página deste site responde em Markdown com `Accept: text/markdown` ou em `/
/index.md` (a inicial em `/index.md`).
**Quando usar a VENUM (when to use):**
- Use quando uma empresa brasileira atende clientes pelo WhatsApp e precisa de mais de uma pessoa atendendo o mesmo número, com filas por setor, transferência, histórico que fica com a empresa e controle de leads e pedidos.
- Use quando a empresa quer a conexão OFICIAL com a WhatsApp Business Platform (API da Meta) sem trocar de número: o WhatsApp Business continua no celular (coexistência) e o atendimento também roda no painel.
- Use quando a empresa anuncia na Meta e quer que qualificação e compra voltem para o anúncio pela API de Conversões, com o valor real do pedido.
- Use quando uma rede com várias lojas ou unidades precisa de uma recepção que descobre a cidade do cliente e entrega a conversa para a unidade certa (modo Roteador).
- Use quando a empresa quer uma IA opcional que atende com o próprio catálogo e horários, entende áudio e agenda horários — sempre com humanos podendo assumir.
- Use a API pública (https://venum.app.br/desenvolvedores/) quando um sistema externo precisa ler contatos e pedidos, enviar mensagens ou mover leads no funil, e webhooks para ser avisado de mensagens, leads e pedidos.
- Não é indicada para: uso pessoal do WhatsApp, automação sem a API oficial da Meta, disparo em massa para quem não deu opt-in (templates precisam de aprovação da Meta), ou empresas fora do Brasil (o produto e o suporte são em português e o atendimento comercial é para o Brasil).
- Como um agente deve agir: para orçamento, demonstração ou dúvidas comerciais, direcione a pessoa ao WhatsApp oficial (https://wa.me/5547936183868) — a contratação é mensal, sem fidelidade, e o valor depende do plano; não invente preços. Para integrar, a empresa gera a chave de API no painel (Integrações); nunca envie mensagens em nome de uma empresa sem a chave dela.
## Páginas
- [Início](https://venum.app.br/): o que a VENUM faz, recursos, formas de usar, perguntas frequentes e manifesto em vídeo.
- [Sobre](https://venum.app.br/sobre/): quem desenvolve (Cobra, Tech Provider da Meta), coexistência, três formas de usar, para quem.
- [Contato](https://venum.app.br/contato/): WhatsApp, e-mail, endereço, canais para demonstração, suporte, agências e privacidade.
- [Desenvolvedores](https://venum.app.br/desenvolvedores/): API REST (conta, contatos, pedidos, mensagens, leads), webhooks assinados, erros.
- [Política de privacidade](https://venum.app.br/privacidade/): controladora/operadora, dados tratados, compartilhamentos, prazos, direitos (LGPD).
- [Política de cookies](https://venum.app.br/politica-de-cookies/): pixel da Meta, cookies usados e como recusar.
## Desenvolvedores
- [OpenAPI 3.1](https://venum.app.br/openapi.json): descrição completa da API https://dash.venum.app.br/api/v1 e dos webhooks.
- [Catálogo de APIs (RFC 9727)](https://venum.app.br/.well-known/api-catalog): linkset apontando para a descrição e a documentação da API.
- [Documentação no painel](https://dash.venum.app.br/integracoes/docs): exige login; mostra o que a conta consegue fazer.
## Optional
- [llms-full.txt](https://venum.app.br/llms-full.txt): todo o conteúdo do site em um único arquivo Markdown.
- [Sitemap](https://venum.app.br/sitemap.xml): lista de páginas.
- [Cobra](https://cobra.art.br/): a empresa que desenvolve a VENUM (tem o próprio llms.txt em https://cobra.art.br/llms.txt).
---
# VENUM — API Oficial do WhatsApp | Cobra Tech Provider
> Seu WhatsApp, sua equipe e toda a operação conectados pela API Oficial. A VENUM é desenvolvida pela Cobra, Tech Provider da Meta, em Timbó, SC, para todo o Brasil.
Versão em Markdown da página inicial (https://venum.app.br/). Outras páginas: [Sobre](https://venum.app.br/sobre/) · [Contato](https://venum.app.br/contato/) · [Desenvolvedores](https://venum.app.br/desenvolvedores/) · [Privacidade](https://venum.app.br/privacidade/) · [Cookies](https://venum.app.br/politica-de-cookies/) · [llms.txt](https://venum.app.br/llms.txt)
## Toda conversa. Um novo começo.
Atendimento, clientes e inteligência no mesmo lugar, para sua equipe ir além do primeiro olá. WhatsApp oficial, conexões reais.
- Conexão oficial com a WhatsApp Business Platform (API da Meta)
- Atendimento em equipe com um só número
- IA opcional
## Da primeira mensagem ao próximo pedido
1. **Um olá abre a conversa.** O cliente chega pelo WhatsApp. A conexão oficial leva a mensagem para a VENUM.
2. **A equipe atende.** Filas por setor, transferência com resumo e notas internas. Cada atendente com seu acesso, cada conversa com seu contexto.
3. **O pedido é registrado** dentro da conversa, com valor e forma de pagamento.
4. **O resultado volta para o anúncio** pela API de Conversões da Meta.
## Oficial no WhatsApp. Essencial para o seu negócio.
- **API Oficial do WhatsApp.** A VENUM conecta sua operação à WhatsApp Business Platform, pela integração oficial da Meta.
- **Seu número continua seu.** Mantenha o WhatsApp Business no celular e leve o atendimento para o painel.
- **O histórico fica com a empresa.** A informação acompanha a conversa, mesmo quando alguém da equipe muda.
- **Tecnologia com quem desenvolve.** A Cobra é Tech Provider da Meta e desenvolve a VENUM. Da conexão à implantação, sua equipe tem com quem contar.
## Tudo conversa. Tudo se conecta.
- **Atendimento** — uma equipe inteira, um só número: filas por setor, transferência com resumo, notas internas, histórico da empresa, respostas rápidas, celular e painel sincronizados.
- **Clientes** — funil de leads (novo, atendimento, qualificado, adiado, ganho, perdido), etiquetas, valor do pedido.
- **Campanhas** — envios com templates aprovados pela Meta.
- **Inteligência artificial** — módulo opcional configurado com catálogo, horários e jeito de atender; franquia mensal e recarga pelo painel.
- Módulos: Faturamento, Templates, Leads, Anúncios, Agenda, Prospecção, Equipe.
## O celular continua. A operação evolui.
Converse pelo WhatsApp Business e acompanhe a operação no painel. Na conexão, a Meta pode enviar até 6 meses de histórico.
## O próximo passo já está conectado
- **Pedidos e faturamento** — lance o pedido na conversa; acompanhe recebido e a receber, filtre por mês e encontre o histórico de recompra.
- **Anúncios com mais contexto** — qualificação e compra voltam para a Meta pela API de Conversões, com o valor real do pedido.
- **Inteligência na sua rotina** — configure a IA com seu catálogo, horários e jeito de atender.
## A VENUM no seu mundo
Escolas e cursos de idiomas (da primeira conversa à matrícula), clínicas, academias e qualquer empresa que atende pelo WhatsApp.
## Uma plataforma. Três formas de usar.
- **Painel completo** — atendimento, clientes, pedidos e campanhas em uma operação conectada. Cada atendente tem seu login; o histórico continua com a empresa.
- **Roteador** — recepção automática que descobre a cidade do cliente e entrega a conversa para a unidade certa.
- **Só qualificar** — a plataforma recebe, organiza e qualifica; a equipe entra com contexto.
## Simples, desde o começo
1. **Conecte seu número** — ative a conexão oficial pelo painel e mantenha seu WhatsApp Business.
2. **Traga sua equipe** — configure acessos e departamentos para organizar cada atendimento.
3. **Conte com a Cobra** — receba apoio para configurar a IA, preparar campanhas e começar a operação.
## Perguntas frequentes
**Preciso trocar meu número?** Não. Você mantém o número e o WhatsApp Business no celular, conectado ao painel pela via oficial. A disponibilidade da coexistência e do histórico é conferida na conexão.
**O que significa Tech Provider?** A Cobra desenvolve a VENUM e integra seus recursos à WhatsApp Business Platform como Provedora de Tecnologia da Meta.
**A inteligência artificial está incluída?** A IA é um módulo opcional. Pode atender com as informações da sua empresa, entender áudio e agendar horários. Consulte a equipe para conhecer as condições.
**Tem fidelidade?** A contratação é mensal, sem fidelidade. Você pode cancelar e o número continua sendo seu.
**A demonstração do site envia mensagens reais?** Não. A simulação da página usa contatos fictícios e respostas predefinidas.
**Sou agência. Posso trabalhar com a VENUM?** Sim: converse com a Cobra para conhecer a implantação e a revenda como agência homologada.
## Manifesto
Um minuto sobre o que acreditamos: tecnologia que aproxima, contexto que continua e uma equipe pronta para o próximo passo. Vídeo de 58 segundos em https://venum.app.br/#manifesto.
## Grandes negócios. Boas conversas.
Vamos conectar o próximo capítulo da sua empresa? Agende uma demonstração pelo WhatsApp: https://wa.me/5547936183868 (+55 47 93618-3868). Agências: https://wa.me/5547936183868?text=Sou%20ag%C3%AAncia%20e%20quero%20revender%20a%20Venum
---
VENUM · Cobra · Tech Provider da Meta · Timbó, SC · Para todo o Brasil · Painel: https://dash.venum.app.br
---
# Sobre a VENUM
> A VENUM é a plataforma da Cobra para atendimento, clientes e vendas pelo WhatsApp, com a API Oficial da Meta. Um só número, toda a equipe no mesmo lugar e o histórico com a empresa.
Página: https://venum.app.br/sobre/ · [Início](https://venum.app.br/) · [Contato](https://venum.app.br/contato/) · [Desenvolvedores](https://venum.app.br/desenvolvedores/) · [llms.txt](https://venum.app.br/llms.txt)
## O que é
A VENUM conecta a operação da sua empresa à WhatsApp Business Platform, a integração oficial da Meta. O cliente chega pelo WhatsApp, a conversa aparece no painel e a equipe atende com filas por setor, transferência com resumo, notas internas e respostas rápidas. Cada atendente tem o próprio acesso; cada conversa carrega o próprio contexto.
Da conversa ao resultado: leads avançam no funil, pedidos são lançados dentro do atendimento, o faturamento fica visível (recebido e a receber) e a qualificação e a compra voltam para a Meta pela API de Conversões, com o valor real do pedido. Campanhas usam templates aprovados. A inteligência artificial é um módulo opcional: atende com o catálogo e os horários da empresa, entende áudio e agenda horários.
## Quem desenvolve
A VENUM é desenvolvida pela [Cobra](https://cobra.art.br) (CBR Marketing Ltda), agência de marketing e tecnologia de Timbó, Santa Catarina, e Tech Provider da Meta. Ser Tech Provider significa que a Cobra integra os recursos da plataforma à WhatsApp Business Platform como Provedora de Tecnologia da Meta. Da conexão do número à implantação, a equipe que desenvolve o produto é a mesma que acompanha a sua operação.
Atendemos empresas de todo o Brasil. Agências podem trabalhar com a VENUM como agência homologada, com implantação e revenda.
## O seu número continua seu
Na conexão oficial, o WhatsApp Business continua no celular e o atendimento também fica disponível no painel: é a coexistência. Você não troca de número e, quando a Meta permite, até seis meses de histórico vêm junto na conexão. A contratação é mensal, sem fidelidade. Se um dia você cancelar, o número segue sendo seu.
## Três formas de usar
- **Painel completo** — atendimento, clientes, pedidos e campanhas em uma operação conectada, com um login por atendente.
- **Roteador** — uma recepção automática que descobre a cidade do cliente e entrega a conversa para a unidade certa, com rodízio ou proximidade entre as lojas.
- **Só qualificar** — a plataforma recebe, organiza e qualifica o contato; a equipe entra quando a conversa já tem contexto.
## Para quem
Redes de lojas, escolas e cursos, clínicas, academias, indústrias com atendimento comercial e qualquer empresa que atende pelo WhatsApp e precisa de equipe, histórico e resultado no mesmo lugar. Para integrar com o sistema que a empresa já usa, há uma [API pública com webhooks](https://venum.app.br/desenvolvedores/).
## Onde estamos
Rua Blumenau, 702, Sala 01, Bairro dos Estados, Timbó, SC, CEP 89093-438. CNPJ 61.986.985/0001-60. Painel em https://dash.venum.app.br.
Agendar demonstração: https://wa.me/5547936183868 (+55 47 93618-3868).
---
# Fale com a VENUM
> Uma conversa pelo WhatsApp resolve quase tudo: demonstração, dúvidas sobre a conexão oficial, suporte e parcerias. Respondemos em dias úteis, em horário comercial (Brasília).
Página: https://venum.app.br/contato/ · [Início](https://venum.app.br/) · [Sobre](https://venum.app.br/sobre/) · [Privacidade](https://venum.app.br/privacidade/) · [llms.txt](https://venum.app.br/llms.txt)
## WhatsApp
Número oficial: **+55 47 93618-3868** — https://wa.me/5547936183868. Ele é atendido pela própria VENUM: você já chega numa operação conectada pela API Oficial.
- Agendar uma demonstração (painel, coexistência com o celular, IA): https://wa.me/5547936183868?text=Ol%C3%A1!%20Quero%20conhecer%20a%20Venum%20e%20agendar%20uma%20demonstra%C3%A7%C3%A3o.
- Suporte para quem já usa (conexão, equipe, templates, integrações): https://wa.me/5547936183868?text=Ol%C3%A1!%20J%C3%A1%20uso%20a%20Venum%20e%20preciso%20de%20ajuda.
- Sou agência (implantação e revenda como agência homologada): https://wa.me/5547936183868?text=Ol%C3%A1!%20Sou%20ag%C3%AAncia%20e%20quero%20saber%20como%20revender%20a%20Venum.
## E-mail
- Assuntos comerciais e gerais: contato@cobra.art.br
- Privacidade e dados pessoais (LGPD): privacidade@cobra.art.br — veja a [política de privacidade](https://venum.app.br/privacidade/).
## Endereço
CBR Marketing Ltda (Cobra) · Tech Provider da Meta
Rua Blumenau, 702, Sala 01
Bairro dos Estados · Timbó, SC · CEP 89093-438
CNPJ 61.986.985/0001-60 · Telefone da Cobra: +55 47 99915-0241
Atendemos empresas de todo o Brasil; a implantação é feita remotamente, pelo painel e pelo WhatsApp.
## Já é cliente?
O painel fica em https://dash.venum.app.br. Desenvolvedores encontram a API, o OpenAPI e os webhooks em https://venum.app.br/desenvolvedores/.
---
# API da VENUM
> Tudo em JSON, sobre HTTPS, na base `https://dash.venum.app.br/api/v1`. Uma chave de API dá acesso a uma conta — a mesma que aparece no painel de quem gerou a chave. Webhooks avisam o seu sistema em vez de ele ficar perguntando.
Página: https://venum.app.br/desenvolvedores/ · [OpenAPI 3.1](https://venum.app.br/openapi.json) · [Catálogo de APIs (RFC 9727)](https://venum.app.br/.well-known/api-catalog) · [llms.txt](https://venum.app.br/llms.txt) · [Documentação no painel (login)](https://dash.venum.app.br/integracoes/docs)
## Como obter uma chave
No painel (https://dash.venum.app.br), em **Integrações**, gere uma chave `vnm_…`. Chave **somente leitura** responde apenas aos `GET`; para enviar mensagem ou mover lead, gere uma de **acesso total**. A chave vale para uma conta e pode ser revogada a qualquer momento.
## Autenticação
Mande a chave no cabeçalho `Authorization`. Toda rota exige.
```bash
curl https://dash.venum.app.br/api/v1/conta \
-H "Authorization: Bearer vnm_SUACHAVE"
```
## Rotas
| Método | Rota | O que faz |
| --- | --- | --- |
| GET | `/api/v1/conta` | Confirma a chave e mostra a conta (o "ping" da integração). |
| GET | `/api/v1/contatos` | Lista contatos — filtros: `estagio` (novo, atendimento, qualificado, adiado, ganho, perdido), `desde` (AAAA-MM-DD), `busca`, `limite` (até 200), `pagina`. |
| GET | `/api/v1/pedidos` | Vendas registradas, com resumo (quantidade, valor total, recebido, a receber) — filtros: `desde`, `ate`, `status` (`recebido` / `a_receber`). |
| POST | `/api/v1/mensagens` | Envia mensagem pelo WhatsApp da conta: texto (janela de 24h) ou template aprovado. |
| PATCH | `/api/v1/leads/{id}` | Move o lead no funil; `ganho` com valor cria o pedido e dispara a API de Conversões. |
Listas são paginadas (`paginacao.pagina`, `limite`, `total`) e vêm ordenadas da mais recente para a mais antiga. Cada contato traz `janela_aberta`: se o cliente escreveu nas últimas 24h, texto livre é entregue; passou disso, o WhatsApp exige um template aprovado. Valores monetários nas listas (`valor`) chegam como texto decimal (ex.: `"249.90"`); o filtro `estagio` ainda não aceita `sem_resposta`.
## Enviar uma mensagem
```bash
curl -X POST https://dash.venum.app.br/api/v1/mensagens \
-H "Authorization: Bearer vnm_SUACHAVE" \
-H "Content-Type: application/json" \
-d '{ "telefone": "5547999990000", "texto": "Seu pedido saiu para entrega!" }'
```
Fora da janela de 24h, envie um template aprovado (se vierem `texto` e `template` juntos, vale o template):
```json
{ "telefone": "5547999990000",
"template": { "nome": "aviso_envio", "idioma": "pt_BR", "variaveis": ["Maria", "BR123456789"] } }
```
Resposta: `{ "enviada": true, "mensagem_id": "wamid…", "contato_id": 1234 }`. Se o contato ainda não existir, ele é criado (e o evento `contato.criado` é emitido).
## Mover um lead
Estágios: `novo`, `atendimento`, `qualificado`, `adiado`, `sem_resposta`, `ganho`, `perdido`.
```bash
curl -X PATCH https://dash.venum.app.br/api/v1/leads/1234 \
-H "Authorization: Bearer vnm_SUACHAVE" \
-H "Content-Type: application/json" \
-d '{ "estagio": "ganho", "valor": 249.90, "produto": "Plano anual" }'
```
Marcar `ganho` com `valor` maior que zero cria o pedido e envia a conversão para a Meta — exatamente como se alguém tivesse clicado no painel. A resposta traz `pedido_id` e `capi.enviada`. Valor negativo é recusado (`valor_invalido`). Para `adiado`, informe `retomar_em` (AAAA-MM-DD) e, se quiser, `retomar_motivo`.
## Webhooks
Cadastre um endereço em **Integrações**, escolha os eventos e responda com qualquer `2xx` em até 10 segundos. Outra resposta, ou tempo esgotado, faz a VENUM tentar de novo em 5, 30, 120 e 360 minutos (5 tentativas no total; depois a entrega fica marcada como falha no painel). Cada entrega vem com `User-Agent: Venum-Webhook/1` e os cabeçalhos `X-Venum-Event`, `X-Venum-Delivery` e `X-Venum-Signature` (`t=