Como registrar um número de telefone da Twilio e enviar um SMS usando a CLI da Twilio

Há mais de 4,5 bilhões de dispositivos habilitados para texto. Isso cria uma enorme oportunidade para notificar as pessoas sobre compromissos futuros, eventos especiais, notícias de última hora ou promoções comerciais via SMS. O envio de mensagens SMS de forma programática permite o alcance de muitas pessoas de forma quase instantânea. Com o Twilio Programmable SMS, você pode registrar seu próprio número de telefone virtual e enviar mensagens SMS para todo o mundo.

Este tutorial mostrará como configurar a CLI da Twilio, registrar um número de telefone e enviar um SMS usando o novo número

Observação importante sobre conformidade: existem regras para o uso de mensagens SMS, e elas variam de país a país. Familiarize-se com as regras dos países em que enviará mensagens com as Diretrizes regulatórias da Twilio para SMS.

Pré-requisitos

Para realizar o projeto descrito neste tutorial, você precisará dos seguintes recursos e ferramentas:

• Conta Twilio: cadastre-se gratuitamente usando este link e receba US$ 10 adicionais em crédito ao atualizar para uma conta básica.
• CLI da Twilio: a interface de linha de comando da Twilio requer Node.js e npm, que é instalada com Node.js.

Compre um número de telefone da Twilio

As mensagens SMS da Twilio são enviadas usando os números de telefone da Twilio, que fornecem acesso instantâneo a números de telefone gratuitos, locais, nacionais e móveis em mais de 100 países, com uma API criada para desenvolvedores. Você pode ter um número de telefone da Twilio gratuitamente como parte de sua conta de avaliação.

Depois de criar uma conta Twilio, você poderá usar a CLI da Twilio para obter um número de telefone.

Observação: se você já tiver instalado a CLI, certifique-se de ter a versão mais recente executando o seguinte comando:

Se você tiver armazenado suas credenciais da Twilio como variáveis de ambiente, a CLI da Twilio as usará automaticamente. Caso contrário, você terá de fazer login usando o seguinte comando:

Este comando solicitará o SID da sua conta e o token de autenticação, ambos disponíveis no console da Twilio.

Para listar os números de telefone disponíveis para registro, use o comando a seguir, substituindo o código de país ISO 3166 alpha-2 apropriado por "US", se necessário:

Você verá uma lista semelhante à saída abaixo:

Copie um dos números da lista e registre-o em sua conta Twilio usando:

Se sua tentativa de registro for bem-sucedida, você verá:

Uma vez registrado, o número de telefone estará disponível para uso (até que você o libere usando a CLI ou o console da Twilio). Observe que o SID associado ao número de telefone é um segredo de usuário e deve ser manipulado com segurança.

Para verificar se o número foi adicionado à sua conta corretamente, você pode usar a CLI da Twilio para enviar uma mensagem de teste. Execute o seguinte comando, tomando cuidado para substituir os valores de espaço reservado pelo número de telefone da Twilio e seu número pessoal habilitado para SMS no formato E.164:

Observação: com uma conta de teste, você só pode enviar mensagens para números de telefone que já tenha registrado em sua conta. O número de telefone habilitado para SMS usado para se cadastrar na sua conta Twilio é o primeiro número registrado.

A API retornará uma resposta semelhante à saída abaixo para indicar que a mensagem SMS foi recebida com sucesso e está na fila para ser enviada:

Dentro de pouco tempo, você deve receber uma mensagem SMS em seu telefone:

Você pode verificar o status da solicitação de criação de mensagem usando o seguinte comando da CLI:

Você verá uma resposta semelhante a esta:

Se a sua mensagem não for entregue, você poderá utilizar os registros de status no console da Twilio para ajudar você a identificar o problema. Se você estiver usando uma conta Twilio de avaliação, certifique-se de estar enviando para um número de telefone registrado.

Resumo

Neste post, você aprendeu como instalar e configurar a CLI da Twilio e como obter um número de telefone da Twilio. Esse número é necessário para trabalhar com alguns dos produtos Twilio, como Programmable SMS. Você também aprendeu a enviar SMS para qualquer número habilitado para SMS em todo o mundo com a CLI da Twilio.

Recursos adicionais

Maciej Treder é engenheiro sênior de desenvolvimento de software da Akamai Technologies. Ele também é palestrante de conferência internacional e autor do @ng-toolkit. Saiba mais sobre ele em https://www.maciejtreder.com. Você também pode entrar em contato com ele em: contact@maciejtreder.com ou @maciejtreder no GitHub, Twitter, StackOverflow e LinkedIn.

Gabriela Rogowska contribuiu para este post.