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
npm install -g ligar-cobrancaVocê pode configurar a ferramenta de duas maneiras:
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-cobrancaE seguir as instruções na tela.
Se preferir, você pode criar manualmente um arquivo .env na raiz do projeto:
ZENVIA_TOKEN=seu_token_aqui
ZENVIA_PHONE_NUMBER=seu_numero_de_origemPara obter seu token, acesse https://app.zenvia.com/
ligar-cobrancaO 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: +5511999999999)
- 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.
ligar-cobranca --para=NUMERO_DESTINO [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 |
0- Ricardo (BR)1- Vitória (BR)2- Joey (EN)3- Maxim (RUS)
1- Muito lento (0.5x)2- Lento (0.75x)3- Normal (1x)4- Rápido (1.5x)5- Muito rápido (2x)
ligar-cobranca --para=+5511999999999 --voz=0 --velocidade=3 --gravarligar-cobranca --numeros=+5511999999999,+5511888888888 --quantidade=5ligar-cobranca --para=+5511999999999 --texto="Olá, isso é um teste" --voz=1ligar-cobranca --para=+5511999999999 --texto="Olá" --gravarligar-cobranca --para=+5511999999999 --debug- O número de origem (
--de) deve estar no formato internacional (ex: +5511999999999) - 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)
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=+5511999999999 --debugMIT
Não sou responsável pelo uso que você faz desta ferramenta. Use com responsabilidade e de acordo com as leis locais.