Venda pelo Claude Code

1. A skill oneclicksales

Opera o OneClick Sales pela API pública /v1, em nome de uma ou várias empresas, cada uma identificada pelo CNPJ. Envia WhatsApp, WhatsApp Oficial, SMS, e-mail, ligação com IA e vídeo para um contato e dispara em massa (até 30 mil contatos por chamada); consulta plano, saldo, limites e o andamento dos envios; registra opt-in, cuida da lista de bloqueio e do webhook; e gera o Pix de recarga e de renovação do plano.

O que vem na pasta:

Para desenvolvedores: a descoberta automática de skills está em /.well-known/agent-skills/index.json, e a especificação completa da API, em /openapi-v1.json e na página Desenvolvedores.

2. Antes de começar: conta com CNPJ

O OneClick Sales é uma ferramenta para empresas. Cada conta pertence a uma empresa e é identificada pelo CNPJ dela — CPF não é aceito, nem no cadastro, nem na skill.

• Um CNPJ, uma conta. O mesmo CNPJ não fica em duas contas.
• Filial é outra conta, com o CNPJ dela (final /0002-…, /0003-…), ligada às outras pela Organização (Minha Conta › White Label/Organização).
• Para usar a API: conta criada em /cadastro, cadastro da empresa completo em Minha Conta (razão social, CNPJ ativo na Receita, telefone e endereço) e um plano em vigor que inclua a API (Planos e Preços).
• No computador: o Claude Code e o Node.js 18 ou mais novo (para o script da skill).

3. Criar a chave da API

Só o titular da conta cria chaves (a equipe da conta, os subusuários, não).

1. Entre na sua conta e abra Minha Conta › Integrações › Chaves de API.
2. Escolha o ambiente: comece por Sandbox (ocs_test_pk_…) — ele lê os dados reais da conta e simula os envios, sem enviar nem cobrar. Depois crie a de Produção (ocs_live_pk_…), que envia e cobra de verdade.
3. Marque só os métodos de que o Claude Code precisa, e sempre Conta e plano (account.read): é por ele que a skill confere de qual CNPJ é a chave.
4. Opcional: em IPs permitidos, o endereço do computador que vai usar a chave.
5. Dê um nome que diga quem usa (ex.: "Claude Code – Ana") e copie a chave na hora: ela aparece uma vez só.

4. Instalar no Claude Code

No terminal, baixe a skill e descompacte na pasta de skills do seu usuário (a pasta oneclicksales já vem dentro do ZIP):

# macOS / Linux
mkdir -p ~/.claude/skills
curl -fsSLo /tmp/oneclicksales.zip https://oneclicksales.com.br/skills/oneclicksales.zip
unzip -o /tmp/oneclicksales.zip -d ~/.claude/skills

# Windows (PowerShell)
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Invoke-WebRequest https://oneclicksales.com.br/skills/oneclicksales.zip -OutFile "$env:TEMP\oneclicksales.zip"
Expand-Archive "$env:TEMP\oneclicksales.zip" "$HOME\.claude\skills" -Force

Para usar só num projeto, descompacte em .claude/skills/ dentro dele (e não versione chaves).

Alternativa: plugin do Claude Code (MCP)

No Claude Code há também o plugin oficial, que liga o servidor MCP da API (/v1/mcp). Dentro do Claude Code:

/plugin marketplace add https://oneclicksales.com.br/integracoes/claude-code/marketplace.json
/plugin install oneclicksales@oneclicksales

O plugin pede a chave num campo mascarado na instalação (para trocá-la depois: /plugin configure oneclicksales@oneclicksales), e a skill dele se chama oneclicksales:ferramentas. Instale a skill ou o plugin, não os dois: os dois falam com a mesma conta e com a mesma chave. A skill desta página continua a opção para quem quer o script com a conferência da chave pelo CNPJ, para uma ou várias empresas.

5. Configurar uma empresa

Duas variáveis de ambiente: o CNPJ da empresa e a chave dela. O CNPJ pode ir com ou sem pontuação.

# macOS / Linux (no ~/.zshrc ou ~/.bashrc)
export OCS_CNPJ="11.222.333/0001-81"
export OCS_API_KEY="ocs_test_pk_SUA_CHAVE"

# Windows (PowerShell)
[Environment]::SetEnvironmentVariable('OCS_CNPJ', '11.222.333/0001-81', 'User')
[Environment]::SetEnvironmentVariable('OCS_API_KEY', 'ocs_test_pk_SUA_CHAVE', 'User')

Depois, feche e abra o terminal (e o Claude Code) para que ele enxergue as variáveis.

6. Várias pessoas na mesma empresa

Todas usam o mesmo CNPJ. O titular cria uma chave para cada pessoa, com só os métodos de que ela precisa — dá para ver o uso de cada uma e revogar uma sem parar as outras. Cada pessoa configura no próprio computador o OCS_CNPJ (o mesmo para todos) e o OCS_API_KEY (a chave dela).

O número máximo de chaves ativas por conta aparece na própria API (GET /v1/account/limits).

7. Várias empresas (vários CNPJs)

Grupo com filiais, holding ou agência que atende clientes: cada empresa tem a própria conta e a própria chave. Use uma variável por CNPJ, com os 14 dígitos no nome:

# macOS / Linux
export OCS_API_KEY_11222333000181="ocs_live_pk_CHAVE_DA_MATRIZ"
export OCS_API_KEY_11222333000262="ocs_live_pk_CHAVE_DA_FILIAL"
export OCS_API_KEY_11444777000161="ocs_test_pk_CHAVE_DO_CLIENTE"

# Windows (PowerShell)
[Environment]::SetEnvironmentVariable('OCS_API_KEY_11222333000181', 'ocs_live_pk_CHAVE_DA_MATRIZ', 'User')
[Environment]::SetEnvironmentVariable('OCS_API_KEY_11444777000161', 'ocs_test_pk_CHAVE_DO_CLIENTE', 'User')

• Com mais de uma empresa configurada, o Claude Code pergunta para qual CNPJ é cada ação e nunca escolhe sozinho.
• Antes da primeira chamada de cada chave, a skill pergunta à API de qual CNPJ ela é e só segue se for o CNPJ da variável. Uma chave colada no lugar errado é recusada.
• Dá para misturar: OCS_CNPJ + OCS_API_KEY para a empresa principal e OCS_API_KEY_<CNPJ> para as outras. O mesmo CNPJ com duas chaves diferentes é recusado.
• Agência: a conta e a chave são do cliente (o CNPJ dele, o titular dele). O cliente cria a chave com os métodos combinados e entrega por um canal seguro.

8. Conferir e primeiro uso

Na pasta da skill (~/.claude/skills/oneclicksales):

node scripts/ocs.mjs contas      # os CNPJs configurados, o ambiente e a chave mascarada
node scripts/ocs.mjs conferir    # de qual CNPJ é cada chave, o plano e se a conta pode enviar

Resposta quando está tudo certo:

OK  11.222.333/0001-81  sandbox  Empresa Exemplo Ltda — plano Plano Profissional Mensal (active); pode enviar

Depois, é só pedir ao Claude Code em português. Exemplos:

• "Confira a conta do OneClick Sales do CNPJ 11.222.333/0001-81 e me diga o saldo de cada canal."
• "Monte, no sandbox, um WhatsApp para os contatos desta planilha e me mostre o custo antes de enviar."
• "Como está o disparo de ontem? Quantos foram entregues e quantos falharam?"

9. Segurança e LGPD

• A chave dá acesso à conta da empresa: trate como senha. Nunca no chat, em print, no Git ou em arquivo do projeto. Saiu da equipe ou suspeita de vazamento: revogue em Minha Conta e crie outra.
• Com a chave de produção, o Claude Code mostra a empresa, o canal, quantos contatos, o texto e o custo, e só envia, cobra ou altera depois do seu "sim" para aquela ação.
• Todo envio declara que a empresa tem base legal para contatar quem recebe (consentimento ou legítimo interesse). O Claude Code pergunta antes; a plataforma aplica a lista de bloqueio, o pedido de saída, a janela de envio e uma abordagem por dia por contato em cada canal.

10. Perguntas frequentes

Preciso saber programar?

Não. Você cola os comandos desta página uma vez e, depois, só conversa em português com o Claude Code.

A skill custa alguma coisa?

A skill é gratuita. O que ela faz na conta segue o seu plano, que precisa incluir a API, e os créditos de cada canal, como no painel (Planos e Preços). Com a chave de sandbox nada é cobrado.

Posso usar com CPF?

Não. O OneClick Sales atende só empresas: a conta, o cadastro e a skill trabalham com CNPJ.

Sou MEI. Posso usar?

Sim: o MEI tem CNPJ. Use o CNPJ do MEI, nunca o CPF do titular.

Minha empresa tem filiais. Uso uma chave só?

Não. Cada filial tem CNPJ e conta próprios; crie uma chave em cada conta e configure uma variável por CNPJ.

O Claude Code pode criar a conta ou aceitar os Termos por mim?

Não. Criar a conta, aceitar os Termos de Uso e criar as chaves são passos da pessoa responsável pela empresa.

Dúvidas: [email protected] ou a Central de Ajuda.

Última atualização: 18 de outubro de 2026