Como verificar o saldo da sua conta Twilio no JavaScript

March 25, 2021
Escrito por
Revisado por
Diane Phan
Twilion

Como verificar o saldo da sua conta Twilio no JavaScript

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.

Pré-requisitos

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

  • Node.js instalado na sua máquina
  • Uma conta Twilio gratuita (cadastre-se neste link e ganhe $ 10 em crédito quando fizer o upgrade da conta para a versão paga)

Como criar um projeto Node.js

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.

Como configurar as variáveis de ambiente

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.

Account SID (SID da conta) e auth token (token de autenticação) 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.

Como recuperar o saldo da conta

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.

Como executar o script

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

Conclusão

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!

Este artigo foi traduzido do original "How to Check your Twilio Account Balance in JavaScript". Enquanto melhoramos nossos processos de tradução, adoraríamos receber seus comentários em help@twilio.com - contribuições valiosas podem render brindes da Twilio.