Como usar o C Shell para enviar um SMS de um novo número de telefone da Twilio

Hoje, vamos fazer Bill saltar de alegria comprando um novo número de telefone da Twilio e enviando um SMS diretamente do csh (ou, mais provavelmente do, tcsh). Aqui, você aprenderá a encontrar um número disponível, comprar um número e enviar um SMS com a Twilio sem nunca sair do seu C Shell.

Definir suas credenciais da Twilio em seu C Shell

Clique no console da Twilio para começar. Faça login em sua conta existente ou inscreva‐se em uma conta gratuita (certifique‐se de verificar seu número, você precisará dele mais tarde). Quando isso for feito, procure o Account Summary (Resumo da conta), conforme mostrado abaixo:

Ao usar essas informações, substitua as variáveis account_sid e auth_token abaixo pelas variáveis "ACCOUNT SID" (SID DA CONTA) e "TOKEN AUTH" (TOKEN DE AUTENTICAÇÃO) do console da Twilio. (Clique no ícone de globo ocular para expor seu TOKEN AUTH (TOKEN DE AUTENTICAÇÃO)).

Execute‐os em sua estrutura:

set account_sid="ACXXXXXXXXXXXXXXXXXXXXX"
set auth_token="your_auth_token"

Encontrar um número de telefone da Twilio com cURL no C Shell

Agora que nosso Account SID (SID da conta) e Auth Token (Token de autenticação) estão configurados, podemos consultar a API REST da Twilio para encontrar os números de telefone disponíveis. Precisaremos encontrar um (e comprar) para enviar um SMS de nosso script.

set available_number=`curl -X GET \ "https://api.twilio.com/2010-04-01/Accounts/${account_sid}/AvailablePhoneNumbers/US/Local" \ -u "${account_sid}:${auth_token}" | \ sed -n "/PhoneNumber/{s/.*<PhoneNumber>//;s/<\/PhoneNumber.*//;p;}"` echo $available_number

Se você colar o comando acima e pressionar retornar, available_number será definido para o primeiro número que a Twilio lhe oferecer.

Vamos explorar o que está acontecendo nesta linha ocupada:

set available_number= é a sintaxe para definir uma variável local. Tudo o que estiver contido no acento grave (`) será executado e definido como available_number.
curl -X GET "https://api.twilio.com/[omitted] -u "${account_sid}:${auth_token}" Usamos o pacote de software cURL e o verbo HTTP GET para solicitar ao endpoint de números disponíveis da Twilio um número gratuito. "-u" é o indicador para fornecer credenciais de conta por autenticação básica HTTP. Um ${variable_name} entre aspas duplas substitui os nomes das variáveis que definimos anteriormente neste comando.
"|" Um caractere de barra vertical no shell significa que os resultados do comando anterior são passados para o próximo comando (neste caso, passamos a resposta da Twilio para sed).
sed -n "/PhoneNumber/{s/.*<PhoneNumber>//;s/<\/PhoneNumber.*//;p;}" Usa o pacote de manipulação de fluxo sed para extrair apenas a primeira ocorrência das tags <PhoneNumber> da resposta XML da Twilio
&& permite encadear nossos comandos juntos no shell
echo $available_number imprime a variável available_number no shell.

(Para usuários avançados: observe que "US" após AvailablePhoneNumbers no URI é o código ISO do país.)

Observação: Se você não estiver em uma conta de avaliação, será necessário comprar esse número. Confira nossa página de preços para obter mais detalhes.

Comprar um número de telefone da Twilio no C Shell

Twilio acabou de retornar um número disponível para nós - vamos colocar um toque nele, OK?

Execute o comando a seguir para comprar o número e adicioná‐lo à sua conta:

curl -X POST -F "PhoneNumber=${available_number}" \ "https://api.twilio.com/2010-04-01/Accounts/${account_sid}/IncomingPhoneNumbers" \ -u "${account_sid}:${auth_token}"

Pressione retornar e você deve ser o feliz proprietário de um novo número de telefone da Twilio (se não for, é possível que o número já tenha sido comprado - execute novamente a etapa "número disponível" e tente novamente).

Se você tem olhos de águia, provavelmente notará:

Agora estamos usando o método HTTP POST
Estamos fazendo POST do parâmetro PhoneNumber no endpoint IncomingPhoneNumbers e substituindo o número de telefone encontrado na última etapa

Se tudo correu bem, você agora tem o available_number e está pronto para o grande resultado.

Enviar um SMS com a Twilio no C Shell

Altere a variável your_number abaixo para um número de telefone da Twilio verificado em sua conta e execute a seguinte linha:

set your_number="+15555555555" curl -X POST -F "Body=Hi there, your new phone number is working." \ -F "From=${available_number}" -F "To={$your_number}" \ "https://api.twilio.com/2010-04-01/Accounts/${account_sid}/Messages" \ -u "${account_sid}:${auth_token}"

Este comando envia uma solicitação POST ao recurso Messages com os três parâmetros necessários: Body, From e To. Você deve explorar todos os parâmetros legais para o endpoint Messages e ver como enviar imagens ou definir URLs de retorno de chamada para atualizações no status de entrega de mensagens, entre muitas opções.

Se tudo correu bem, no entanto, seu telefone deve estar tocando ou vibrando em sua mesa. Tente alterar o body para adicionar emojis ou enviar SMS para outros números.

A Twilio toca as campainhas do telefone no C Shell

Atingir endpoints úteis da Twilio sem sair do csh deve acelerar imensamente o tempo de criação de protótipos. O hacking de linha de comando é uma ótima maneira de explorar a API da Twilio e adicionar recursos de comunicação aos seus scripts de shell. Com seu shell e este artigo, você pode pesquisar números, comprar números e enviar mensagens SMS sem sair do csh. Basta usar o que o *NIX oferece.

Um estudo mais aprofundado:

Contribuidores:

Precisa de ajuda?

Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.