Pular para o conteúdo

Você pede. A IA faz.

Seu pedido

Quanto saldo de WhatsApp eu tenho?

A IA chamou

  1. api_indexchave de produção, com os métodos que você marcouchave de sandbox: lê os dados reais, não envia nem cobra
  2. account_creditsWhatsApp: 1.240 créditos · SMS: 850
  1. account_creditssaldo de WhatsApp para os 120 contatos
  2. blocklist_check3 pediram para sair e ficam de fora
  3. dispatches_create117 contatos, dentro da janela: aguardando o seu "sim"
  4. dispatches_createdryRun: conferido como em produção, nada enviado
  1. billing_rechargeCreditsPix gerado: o QR Code e o copia e cola na conversa
  2. billing_paymentStatusaguardando o pagamento
  3. billing_rechargeCreditsrecusado no sandbox: cobrança só com a chave de produção

Sua chave

Envia e cobra de verdade, depois do seu "sim".Confere tudo como em produção e não envia nem cobra.

Ligue o Claude, o ChatGPT, o Codex ou o Cursor à sua conta OneClick Sales: a IA confere saldo e bloqueios, aborda por WhatsApp, SMS, e-mail e ligação e só envia depois do seu "sim".

Conectar meu assistente Ver as 36 ferramentas

Exemplo ilustrativo, com números de demonstração. Na sua conta, a IA usa os seus dados e só os métodos que a sua chave libera.

Conecte em um minuto

Primeiro, ligue o assistente à sua conta.

Instale o plugin oficial dentro do Claude Code. Ele pede a sua chave num campo protegido.

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

No Claude (web e desktop) ou no ChatGPT, onde o seu plano permite conector MCP personalizado: adicione um conector com este endereço e entre com a sua conta OneClick Sales. Você escolhe o que a IA pode fazer antes de liberar.

https://oneclicksales.com.br/v1/mcp

No Codex (terminal e editor), acrescente ao ~/.codex/config.toml e deixe a chave na variável OCS_API_KEY.

[mcp_servers.oneclicksales]
url = "https://oneclicksales.com.br/v1/mcp"
bearer_token_env_var = "OCS_API_KEY"

No Cursor, no Windsurf e em outros assistentes com MCP por HTTP, use esta configuração com a sua chave.

{
  "mcpServers": {
    "oneclicksales": {
      "type": "http",
      "url": "https://oneclicksales.com.br/v1/mcp",
      "headers": { "Authorization": "Bearer ocs_test_pk_…" }
    }
  }
}

No seu código, pela ferramenta mcp da API Responses da OpenAI. As chamadas saem dos servidores da OpenAI: chave com lista de IPs só funciona com os IPs deles na lista.

{
  "type": "mcp",
  "server_label": "oneclicksales",
  "server_url": "https://oneclicksales.com.br/v1/mcp",
  "headers": { "Authorization": "Bearer ocs_test_pk_…" },
  "require_approval": "always"
}

oneclicksales conectado

As ferramentas que aparecem são só as dos métodos da sua chave. A chave de sandbox (ocs_test_pk_…) lê os dados reais e não envia nem cobra nada.

Depois, peça como pediria a alguém da equipe.

Quem respondeu ao WhatsApp de ontem? Mande um lembrete para quem não respondeu.
  • dispatches_listo disparo de ontem: 120 contatos
  • dispatches_results94 entregues, 31 lidas, 7 respostas
  • blocklist_check2 pediram para sair e ficam de fora
  • dispatches_createlembrete para 85 contatos, preparado

Vou enviar o lembrete por WhatsApp para 85 contatos, dentro da janela de envio. Posso enviar?

Por fim, confirme. Só então sai.

sim

Lembrete em andamentodispatches_get

85na fila
61entregues
18lidas
4respostas
  • agoramessage.repliedCarlos S. respondeu: "Pode ser amanhã às 10h?"
  • 1 minmessage.readAna M. leu o lembrete
  • 3 minmessage.delivered12 entregas no último minuto

36 ferramentas, uma por método

Criar a chave

Cada ferramenta é um método da API, com as mesmas regras do painel: o assistente só vê as que a sua chave libera.

Conta, plano e limites

  • O que esta chave pode fazerO que a API faz, o ambiente da chave e os métodos que ela pode chamarapi_indexLêSandbox: dados reais
  • Conta e planoConta e plano: em vigor ou vencendo, validade, dias restantes e cadastro da empresaaccount_readLêSandbox: dados reais
  • Limites da contaLimites atuais: requisições da API, janela de envio, tetos por campanha e por disparoaccount_limitsLêSandbox: dados reais
  • Saldo de créditosSaldo de créditos por canalaccount_creditsLêSandbox: dados reais

Erros, falhas e uso da API

  • Diagnóstico da contaDiagnóstico da conta: plano, saldo, números, provedores, webhook e campanhas pausadasaccount_healthLêSandbox: dados reais
  • Uso da APIUso da API por dia, método e chave, com erros e recusas por limiteaccount_apiUsageLêSandbox: dados reais
  • Últimos erros da APIÚltimas chamadas da API que deram erro, com o código e o id da requisiçãoaccount_apiErrorsLêSandbox: dados reais

Envio para um contato

  • Enviar WhatsAppEnviar WhatsApp para um contatomessages_whatsapp_sendEnviaSandbox: simula, sem enviar
  • Enviar WhatsApp OficialEnviar WhatsApp Oficial (modelo aprovado) para um contatomessages_whatsappOfficial_sendEnviaSandbox: simula, sem enviar
  • Enviar SMSEnviar SMS para um contatomessages_sms_sendEnviaSandbox: simula, sem enviar
  • Enviar e-mailEnviar e-mail para um contatomessages_email_sendEnviaSandbox: simula, sem enviar
  • Fazer ligação com IAFazer uma ligação de voz com IAcalls_voice_createEnviaSandbox: simula, sem enviar
  • Enviar vídeo com avatarEnviar vídeo com avatar para um contatomessages_video_sendEnviaSandbox: simula, sem enviar
  • Últimos enviosListar os últimos envios avulsos da conta (de todos os contatos)messages_listLêSandbox: dados reais
  • Status de um envioStatus de um envio (enviado, entregue, lido, respondido, falhou)messages_getLêSandbox: dados reais

Disparo em massa

  • Disparo em massaDisparo em massa: até 30 mil contatos em WhatsApp, SMS, e-mail e vozdispatches_createEnviaSandbox: simula, sem enviar
  • Últimos disparosListar os últimos disparos em massadispatches_listLêSandbox: dados reais
  • Andamento de um disparoAndamento de um disparo em massadispatches_getLêSandbox: dados reais
  • Resultado de um disparo por contatoResultado de cada contato de um disparo, com o motivo das falhasdispatches_resultsLêSandbox: dados reais
  • Parar um disparoParar um disparo em massadispatches_cancelAlteraSandbox: simula, sem enviar

LGPD

  • Registrar consentimento (opt-in)Registrar o consentimento (opt-in) de um contatolgpd_optInAlteraSandbox: simula, sem enviar

Números de WhatsApp

  • Números de WhatsAppNúmeros de WhatsApp da conta e se estão conectadoschannels_listLêSandbox: dados reais
  • Conectar número de WhatsAppConectar um número de WhatsApp (QR Code)channels_addNumberAlteraSandbox: só em produção

Cobrança

  • Renovar plano (Pix)Gerar a cobrança Pix da renovação do planobilling_renewPlanAlteraSandbox: só em produção
  • Recarregar créditos (Pix)Gerar a cobrança Pix de uma recarga de créditosbilling_rechargeCreditsAlteraSandbox: só em produção
  • Status de uma cobrança PixStatus de uma cobrança Pixbilling_paymentStatusLêSandbox: dados reais

Webhooks de eventos

  • Ver o webhookVer o webhook de eventos da contawebhook_getLêSandbox: dados reais
  • Configurar o webhookCadastrar ou alterar o webhook de eventoswebhook_setAlteraSandbox: só em produção
  • Remover o webhookRemover o webhook de eventoswebhook_deleteAlteraSandbox: só em produção
  • Trocar o segredo do webhookTrocar o segredo da assinatura do webhookwebhook_rotateSecretAlteraSandbox: só em produção
  • Testar o webhookMandar um aviso de teste ao webhookwebhook_testAlteraSandbox: só em produção
  • Entregas do webhookHistórico de entregas do webhook (7 dias)webhook_deliveriesLêSandbox: dados reais

Contatos e lista de bloqueio

  • Lista de bloqueioListar a lista de bloqueio da contablocklist_listLêSandbox: dados reais
  • Bloquear contatoBloquear contatosblocklist_addAlteraSandbox: só em produção
  • Desfazer bloqueioDesfazer um bloqueio feito pela contablocklist_removeAlteraSandbox: só em produção
  • Conferir bloqueioConferir se contatos estão bloqueadosblocklist_checkLêSandbox: dados reais

Funciona onde você já trabalha

Um endereço só, oneclicksales.com.br/v1/mcp, e a sua chave.

Claude Code

Plugin oficial: dois comandos e a chave num campo protegido.

Claude

Conector personalizado, com o login da sua conta.

ChatGPT

Conector MCP personalizado, nos planos que o permitem.

Codex

Uma linha no config.toml e a chave numa variável.

Cursor

O mcpServers com o endereço e a chave.

API da OpenAI

A ferramenta mcp da API Responses, no seu código.

Perguntas

As ferramentas que enviam, disparam ou cobram são marcadas como ação: o assistente pede a sua aprovação, e o servidor manda mostrar o destinatário, o canal e o texto antes. Para testar sem risco, use a chave de sandbox: nada sai.

Não. No Claude Code são dois comandos; no Claude e no ChatGPT, você cola o endereço e entra com a sua conta. Depois, é só pedir em português.

O MCP não tem preço à parte: cada envio usa os créditos do canal, como no painel. A API está nos planos com API, e a chave de sandbox não gasta créditos.

Só o que os métodos da chave permitem. Você marca os métodos ao criar a chave e pode trocá-los ou revogá-la a qualquer momento em Minha Conta › Integrações.

Valem as regras do painel: lista de bloqueio, janela de envio e uma abordagem por dia. A declaração de consentimento é da sua empresa: o assistente pergunta a você e não presume.

Revogue em Minha Conta › Integrações: ela para na hora. Para diminuir o risco, dê à chave só os métodos que o assistente usa e, se der, uma lista de IPs.

Sim, com qualquer cliente MCP por HTTP: o endereço é https://oneclicksales.com.br/v1/mcp e a autenticação é o cabeçalho Authorization: Bearer com a sua chave, ou o login da conta onde houver conector com OAuth.

Comece pelo sandbox.

A chave de teste confere tudo como em produção e não envia nem cobra nada. Você cria em Minha Conta › Integrações, em menos de um minuto.

Nova chave de API

Para o assistente de IA usar a sua conta pelo MCP.

Sandbox: ocs_test_pk_…, não envia nem cobra.

Criar a chave na minha conta