\n\n\n\n[](https://www.npmjs.com/package/ligar-cobranca)\n[](https://github.com/gtokai/ligar-cobranca/blob/main/LICENSE)\n\nUma ferramenta CLI para fazer chamadas automáticas usando a API da Zenvia.\nApós 7 anos, fiz uma atualização profunda devido a pedidos de suporte de pessoas com pouco ou nenhum conhecimento em programação.\n\nAtualizei as dependências com falhas de segurança, o uso da API da TotalVoice que foi compradda pela ZENVIA e deixei de forma nativo o loop, além de outras melhorias.\n\n[Instalação](#-instalação) • [Como Usar](#-como-usar) • [Exemplos](#-exemplos) • [Configuração](#-configuração)\n\n
\n\n## 🚀 Instalação\n\n```bash\nnpm install -g ligar-cobranca\n```\n\n## ⚙️ Configuração\n\nVocê pode configurar a ferramenta de duas maneiras:\n\n### 1. Usando o Assistente (Recomendado)\nNa primeira vez que você executar a ferramenta, ela irá guiá-lo através de um assistente interativo que ajudará você a configurar o token e o número de origem. Basta executar:\n\n```bash\nligar-cobranca\n```\n\nE seguir as instruções na tela.\n\n### 2. Configuração Manual\nSe preferir, você pode criar manualmente um arquivo `.env` na raiz do projeto:\n\n```env\nZENVIA_TOKEN=seu_token_aqui\nZENVIA_PHONE_NUMBER=seu_numero_de_origem\n```\n\nPara obter seu token, acesse [https://app.zenvia.com/](https://app.zenvia.com/)\n\n## 🎯 Como Usar\n\n### Modo Interativo\n```bash\nligar-cobranca\n```\n\nO modo interativo é perfeito para quem não está familiarizado com comandos de linha. Ele guia você passo a passo através de um assistente amigável:\n\n1. **Token da Zenvia**: Digite seu token ou pressione Enter se já estiver configurado\n2. **Tipo de Chamada**: Escolha entre chamada única ou múltipla\n3. **Número de Destino**: Digite o número no formato internacional (ex: +5511999999999)\n4. **Número de Origem**: Opcional, digite ou pressione Enter para usar o padrão\n5. **Mensagem**: Escolha entre mensagem padrão ou digite uma personalizada\n6. **Voz**: Selecione uma das 4 vozes disponíveis\n7. **Velocidade**: Escolha entre 5 níveis de velocidade\n8. **Gravar**: Decida se deseja gravar a chamada\n9. **Quantidade**: Defina quantas chamadas deseja fazer (1-999)\n10. **Debug**: Ative o modo debug se precisar de mais informações\n\nCada opção é apresentada de forma clara e intuitiva, com menus de seleção quando apropriado.\n\n### Modo CLI\n```bash\nligar-cobranca --para=NUMERO_DESTINO [opções]\n```\n\n## 📋 Opções\n\n| Opção | Descrição | Padrão |\n|-------|-----------|---------|\n| `--para` | Número de destino | - |\n| `--numeros` | Números de destino (separados por vírgula) | - |\n| `--de` | Número de origem | ZENVIA_PHONE_NUMBER do .env |\n| `--texto` | Mensagem para ser convertida em voz | \"Alô? Alô? Alô? Alô? Alô?\" |\n| `--voz` | Voz a ser utilizada | 0 (Ricardo) |\n| `--velocidade` | Velocidade da voz (1-5) | 3 (Normal) |\n| `--gravar` | Gravar a chamada | false |\n| `--quantidade` | Quantidade de chamadas (1-999) | 1 |\n| `--debug` | Ativar modo debug | false |\n\n### Vozes Disponíveis\n- `0` - Ricardo (BR)\n- `1` - Vitória (BR)\n- `2` - Joey (EN)\n- `3` - Maxim (RUS)\n\n### Velocidades\n- `1` - Muito lento (0.5x)\n- `2` - Lento (0.75x)\n- `3` - Normal (1x)\n- `4` - Rápido (1.5x)\n- `5` - Muito rápido (2x)\n\n## 💡 Exemplos\n\n### Chamada Única\n```bash\nligar-cobranca --para=+5511999999999 --voz=0 --velocidade=3 --gravar\n```\n\n### Múltiplas Chamadas\n```bash\nligar-cobranca --numeros=+5511999999999,+5511888888888 --quantidade=5\n```\n\n### Chamada com Mensagem Personalizada\n```bash\nligar-cobranca --para=+5511999999999 --texto=\"Olá, isso é um teste\" --voz=1\n```\n\n### Chamada com Gravação\n```bash\nligar-cobranca --para=+5511999999999 --texto=\"Olá\" --gravar\n```\n\n### Modo Debug\n```bash\nligar-cobranca --para=+5511999999999 --debug\n```\n\n## ⚠️ Importante\n\n- O número de origem (`--de`) deve estar no formato internacional (ex: +5511999999999)\n- Para múltiplas chamadas, forneça pelo menos 2 números\n- A quantidade de chamadas deve estar entre 1 e 999\n- O token da Zenvia deve ter 32 caracteres alfanuméricos\n- A gravação de chamadas está disponível apenas no painel de controle da Zenvia\n- Suporte completo para números internacionais (formato: +55DDDNUMERO)\n\n## 🔍 Modo Debug\n\nUse a opção `--debug` para ver logs detalhados do processo, incluindo:\n- Detalhes da requisição à API\n- Resposta do servidor\n- Informações de progresso\n- Erros detalhados (se houver)\n\n```bash\nligar-cobranca --para=+5511999999999 --debug\n```\n\n## 📝 Licença\n\nMIT\n\n---\n\n\n\n**⚠️ Aviso Legal**\n\nNão sou responsável pelo uso que você faz desta ferramenta. Use com responsabilidade e de acordo com as leis locais.\n\n
\n\n","readmeFilename":"README.md"}