You are viewing the Portuguese (Brazil) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Rate this page:

Início rápido com a Twilio CLI

Versão BETA

Este produto Twilio está atualmente disponível como uma versão beta. Alguns recursos ainda não foram implementados e outros podem ser alterados antes que o produto seja declarado como disponível para o público em geral. Os produtos beta não são abrangidos por um SLA da Twilio. Saiba mais sobre o suporte a produtos beta.

A Twilio CLI permite gerenciar seus recursos da Twilio a partir do terminal ou do prompt de comando. Vamos fazer a instalação e um tour rápido. Siga as instruções abaixo para instalação de sua plataforma específica.

Instale a Twilio CLI

Uma das maneiras mais fáceis de instalar a CLI no macOS é usar o Homebrew. Se ainda não o tiver instalado, visite o site do Homebrew para obter instruções de instalação e, em seguida, retorne aqui.

Depois que o Homebrew estiver instalado, basta executar o seguinte comando para instalar a CLI:

brew tap twilio/brew && brew install twilio

Atualização

Se você já tiver instalado a CLI com Brew e quiser fazer o upgrade para a versão mais recente, execute:

brew upgrade twilio

Aviso para desenvolvedores Node.js

Se você instalou o Node.js versão 10.12 ou superior no Mac, evite possíveis conflitos de versão Node.js instalando a CLI usando o npm:

npm install twilio-cli -g

Antes de começar

Antes de instalar, certifique-se de que você tem o Node.js instalado (versão 12.21 ou superior). Para ver se você instalou o node, tente executar este comando:

node -v

Se o sistema reportar a v12.21 ou superior, pule a próxima etapa.

Como instalar o Node.js no Windows

Usar o Windows Installer (.msi) é a maneira recomendada de instalar o Node.js no Windows. Baixe o instalador da página de download Node.js.

Execute o PowerShell como administrador e digite o seguinte comando:

Set-ExecutionPolicy Bypass -Scope Process

A seguinte saída deve ser exibida:

Alterar a política de execução
A política de execução ajuda na proteção contra scripts em que você não confia. Alterar a política de execução pode expor
você aos riscos de segurança descritos no tópico de ajuda about_Execution_Policies em
https:/go.microsoft.com/fwlink/?LinkID=135170. Deseja alterar a política de execução?
[Y] Sim  [A] Sim para todos  [N] Não  [L] Não para todos  [S] Suspender  [?] Ajuda (o padrão é "N"):

Pressione Y para confirmar a alteração.

Observação: será necessário definir essa política de execução toda vez que executar o PowerShell. Consulte as notas sobre Set-ExecutionPolicy para saber mais.

Versões testadas no Windows

Essas instruções foram testadas nas seguintes versões do Windows:

  • Windows 10 Pro
  • Windows Server 2016

Como instalar a Twilio CLI

A CLI é instalada com o npm (Node Package Manager), que vem com Node.js. Para instalar a CLI, execute o seguinte comando:

npm install twilio-cli -g

A opção -g instala o comando globalmente para que você possa executá-lo de qualquer lugar do sistema.

Atualização

Se você já tiver instalado a CLI com npm e quiser fazer o upgrade para a versão mais recente, execute:

npm install twilio-cli@latest -g

Antes de instalar, certifique-se de que você tem o Node.js instalado (versão 10.12 ou superior). Mesmo que você já tenha instalado o Node por conta própria, a CLI funciona melhor quando você o instala usando nvm. Veja como instalar o nvm na maioria dos sistemas Linux:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

Consulte as instruções de instalação do nvm para obter opções adicionais e etapas de solução de problemas. Depois de instalar o nvm, execute o seguinte comando para instalar e usar a versão LTS mais recente do Node.js:

nvm install --lts
nvm use <Informe a versão relatada acima>

Como instalar outros pré-requisitos da CLI do Twilio no Linux

Dependendo da sua distribuição, execute um dos seguintes comandos:

  • Debian/Ubuntu: sudo apt-get install libsecret-1-dev
  • Red Hat-based: sudo yum install libsecret-devel
  • Arch Linux: sudo pacman -S libsecret

Como instalar a Twilio CLI

A CLI é instalada com o npm (Node Package Manager), que vem com Node.js. Para instalar a CLI, execute o seguinte comando:

npm install twilio-cli -g

A opção -g instala o comando globalmente para que você possa executá-lo em qualquer lugar do sistema.

Atualização

Se você já tiver instalado a CLI com npm e quiser fazer o upgrade para a versão mais recente, execute:

npm install twilio-cli@latest -g

Faça login em sua conta da Twilio

Para acessar sua conta da Twilio, você precisa fornecer as credenciais da Twilio à CLI. Isso pode ser feito pela execução deste comando:

twilio login

Você precisará fornecer o SID de sua conta e o token de autenticação, que podem ser encontrados no dashboard do seu console do Twilio. Isso cria uma chave de API para você que será armazenada com segurança para uso futuro. Visite uso geral para saber mais sobre o uso de vários perfis.

Instale o preenchimento automático da CLI (somente bash ou zsh)

Se você estiver executando bash ou zsh no macOS ou Linux, pode executar um dos dois comandos abaixo (em função do shell que está sendo usado):

twilio autocomplete bash

ou

twilio autocomplete zsh

Siga as instruções fornecidas para instalar o comando de preenchimento automático para a CLI em seu shell.

Reinicie ou abra um novo shell depois de concluir a etapa para instalar o preenchimento automático.

Exploração da Twilio CLI

A melhor maneira de aprender o que pode ser feito com a CLI é simplesmente executar o comando:

twilio

Ao fazer isso, você verá uma lista dos vários tópicos e comandos que podem ser executados. Os tópicos são apenas agrupamentos para mais tópicos e comandos, assim como a estrutura de pastas no sistema de arquivos.

> twilio
catalise o poder da Twilio em sua linha de comando

VERSÃO
  twilio-cli/1.3.6 darwin-x64 node-v10.16.0

USO
  $ twilio [COMMAND]

COMANDOS
  api            acesso avançado a todas as APIs da Twilio
  autocomplete   exibe instruções de instalação do preenchimento automático
  feedback       fornece feedback à equipe de CLI
  help           exibe a ajuda do twilio
  login          adiciona credenciais a um perfil existente da Twilio
  phone-numbers  gerencia números de telefone da Twilio
  plugins        lista os plugins instalados
  profiles       gerencia credenciais de perfis da Twilio

Viu algo de interessante? Tente executar:

twilio api

Como a "api" é um tópico, serão exibidos mais tópicos e comandos contidos neste tópico. Digamos que no processo de exploração, você se deparou com este comando:

twilio api:core:messages:list

Se você executar esse comando, ele listará todas as suas mensagens SMS, que podem ser muitas. Como você pode filtrá-las? Ou, em termos mais gerais, como descobrir quais opções um determinado comando de CLI oferece? A resposta é adicionar "--help" ao comando da seguinte forma:

twilio api:core:messages:list --help

Se você digitar um comando, poderá receber um erro caso não tenha fornecido todas as opções necessárias. Esta é outra situação em que a adição da palavra "--help" ao comando pode fornecer mais informações.

Exemplos

Liste seus números de telefones

twilio phone-numbers:list

Envie uma mensagem de texto

twilio api:core:messages:create \
  --from "+15017122661" \
  --to "+15558675310" \
  --body "I love you 3000"

Mais exemplos

Visite nossa página de Exemplos para ver uma galeria com mais exemplos.

O que vem a seguir?

Agora que você foi apresentado à CLI, quais os próximos passos?

Explore os plugins

A Twilio CLI pode ser estendida por meio de plugins. É possível publicar seu próprio plugin para a comunidade ou torná-lo privado para os fluxos de trabalho de sua empresa ou de seus clientes. Já existem vários plugins disponíveis para você estender sua CLI.

Guia de uso geral

Mais exemplos

Temos uma página inteira cheia de exemplos das várias coisas que podem ser feitas com a Twilio CLI.

Envie-nos feedback

Por fim, gostaríamos de saber sua opinião. Sempre que quiser nos enviar um feedback, basta executar o camando:

twilio feedback
Rate this page:

Precisa de ajuda?

Todos nós às vezes criamos; programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelos Fóruns da Comunidade da Twilio ou na tag Twilio no Stack Overflow.

        
        
        

        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more