ligar-cobranca

📞 Ligar Cobrança

Uma ferramenta CLI para fazer chamadas automáticas usando a API da Zenvia. Após 7 anos, fiz uma atualização profunda devido a pedidos de suporte de pessoas com pouco ou nenhum conhecimento em programação.

Atualizei 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.

Instalação • Como Usar • Exemplos • Configuração

🚀 Instalação

npm install -g ligar-cobranca

⚙️ Configuração

Você pode configurar a ferramenta de duas maneiras:

1. Usando o Assistente (Recomendado)

Na 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:

ligar-cobranca

E seguir as instruções na tela.

2. Configuração Manual

Se preferir, você pode criar manualmente um arquivo .env na raiz do projeto:

ZENVIA_TOKEN=seu_token_aqui
ZENVIA_PHONE_NUMBER=seu_numero_de_origem

Para obter seu token, acesse https://app.zenvia.com/

🎯 Como Usar

Modo Interativo

ligar-cobranca

O 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:

• Token da Zenvia: Digite seu token ou pressione Enter se já estiver configurado
• Tipo de Chamada: Escolha entre chamada única ou múltipla
• Número de Destino: Digite o número no formato internacional (ex: [phone])
• Número de Origem: Opcional, digite ou pressione Enter para usar o padrão
• Mensagem: Escolha entre mensagem padrão ou digite uma personalizada
• Voz: Selecione uma das 4 vozes disponíveis
• Velocidade: Escolha entre 5 níveis de velocidade
• Gravar: Decida se deseja gravar a chamada
• Quantidade: Defina quantas chamadas deseja fazer (1-999)
• Debug: Ative o modo debug se precisar de mais informações

Cada opção é apresentada de forma clara e intuitiva, com menus de seleção quando apropriado.

Modo CLI

ligar-cobranca --para=NUMERO_DESTINO [opções]

📋 Opções

Opção	Descrição	Padrão
--para	Número de destino	-
--numeros	Números de destino (separados por vírgula)	-
--de	Número de origem	ZENVIA_PHONE_NUMBER do .env
--texto	Mensagem para ser convertida em voz	"Alô? Alô? Alô? Alô? Alô?"
--voz	Voz a ser utilizada	0 (Ricardo)
--velocidade	Velocidade da voz (1-5)	3 (Normal)
--gravar	Gravar a chamada	false
--quantidade	Quantidade de chamadas (1-999)	1
--debug	Ativar modo debug	false

Vozes Disponíveis

• 0 - Ricardo (BR)
• 1 - Vitória (BR)
• 2 - Joey (EN)
• 3 - Maxim (RUS)

Velocidades

• 1 - Muito lento (0.5x)
• 2 - Lento (0.75x)
• 3 - Normal (1x)
• 4 - Rápido (1.5x)
• 5 - Muito rápido (2x)

💡 Exemplos

Chamada Única

ligar-cobranca --para=[phone] --voz=0 --velocidade=3 --gravar

Múltiplas Chamadas

ligar-cobranca --numeros=[phone],[phone] --quantidade=5

Chamada com Mensagem Personalizada

ligar-cobranca --para=[phone] --texto="Olá, isso é um teste" --voz=1

Chamada com Gravação

ligar-cobranca --para=[phone] --texto="Olá" --gravar

Modo Debug

ligar-cobranca --para=[phone] --debug

⚠️ Importante

• O número de origem (--de) deve estar no formato internacional (ex: [phone])
• Para múltiplas chamadas, forneça pelo menos 2 números
• A quantidade de chamadas deve estar entre 1 e 999
• O token da Zenvia deve ter 32 caracteres alfanuméricos
• A gravação de chamadas está disponível apenas no painel de controle da Zenvia
• Suporte completo para números internacionais (formato: +55DDDNUMERO)

🔍 Modo Debug

Use a opção --debug para ver logs detalhados do processo, incluindo:

• Detalhes da requisição à API
• Resposta do servidor
• Informações de progresso
• Erros detalhados (se houver)

ligar-cobranca --para=[phone] --debug

📝 Licença

MIT

⚠️ Aviso Legal

Não sou responsável pelo uso que você faz desta ferramenta. Use com responsabilidade e de acordo com as leis locais.