Com as APIs da Twilio, é possível adicionar recursos de comunicação ao seu aplicativo, mas para utilizá-las é preciso monitorar seus gastos e garantir que o saldo da conta não seja zero.

Quando você faz login no console da Twilio, o saldo está disponível na página principal, mas ter que monitorar a conta ativamente é cansativo e nada prático.

Neste tutorial, você vai aprender a criar um script que recupera o saldo da sua conta com o JavaScript. Também é possível programar a execução periódica deste script e até mesmo configurar notificações via SMS caso o saldo fique abaixo de um determinado valor.

Para começar este tutorial, você precisa de:

No terminal, crie uma pasta chamada twilio-balance e altere os diretórios de trabalho para:

mkdir twilio-balance cd twilio-balance 

Execute o seguinte comando para iniciar um novo projeto Node.js:

npm init -y 

Este comando cria um arquivo package.json na pasta twilio-balance.

Com o projeto Node.js configurado, agora você pode instalar as duas dependências necessárias para o app: a a biblioteca auxiliar para Node da Twilio e o dotenv,o pacote usado para carregar variáveis de ambiente:

npm install twilio dotenv 

Para concluir a configuração do projeto, crie um novo arquivo para seu script chamado index.js e um arquivo .env para armazenar as credenciais da sua conta Twilio.

A Biblioteca auxiliar do Node para Twilio usa o Account SID (SID da conta) Twilio e o Auth Token (token de autenticação) para fazer a autenticação. É preciso recuperar essas credenciais no console da Twilio.

Quando encontrar as credenciais, abra o arquivo .env no editor de texto de sua preferência. Na primeira linha do arquivo, adicione o item abaixo e substitua o espaço reservado pelo próprio SID da conta:

ACCOUNT_SID=<YOUR_ACCOUNT_SID> 

Na próxima linha do arquivo, adicione o item abaixo e novamente substitua o espaço reservado pelo próprio token de autenticação:

AUTH_TOKEN=<YOUR_AUTH_TOKEN> 

Salve e feche este arquivo porque não será usado novamente.

Agora, você está pronto para recuperar o saldo da sua conta Twilio com o JavaScript!

Abra o arquivo index.js que está no diretório twilio-balance. Insira o seguinte código neste arquivo:

require('dotenv').config(); const client = require('twilio')(process.env.ACCOUNT_SID, process.env.AUTH_TOKEN) client.balance.fetch() .then((data) => { const balance = Math.round(data.balance * 100) / 100; const currency = data.currency; console.log(`Your account balance is ${balance} ${currency}.`) }); 

Primeiro, o código carrega as variáveis de ambiente e, depois, inicializa um novo Twilio Client usando a Biblioteca auxiliar do Node.

Em seguida, usa o cliente para obter os dados de saldo da conta, que são devolvidos na forma de um objeto. Como exemplo, estes são os dados devolvidos pelo meu script:

{ accountSid: 'XXXXXXXXXXXXXXXXX', balance: '125.80656', currency: 'USD' } 

Com os valores desse objeto, o código arredonda o saldo da conta para duas casas decimais e registra uma mensagem no console com as informações do saldo e da moeda.

Pronto! Salve e feche o arquivo.

Volte ao terminal para executar o script:

node index.js 

Em alguns instantes, é possível visualizar a seguinte mensagem no console: "Your account balance is <your balance> <your currency>" (O saldo da sua conta é <seu saldo> <sua moeda>).

E pronto! Agora, é possível incorporar esta pequena porção de lógica a um aplicativo maior para verificar seu saldo sempre que precisar. Se preferir, é possível programar o script e enviar para você mesmo uma notificação via SMS com o saldo.

Espero que ajude a melhorar sua experiência de uso das APIs da Twilio. Mal posso esperar para ver o que você criou!