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

Menu

Expand
Classifique esta página:

Início rápido do Programmable SMS com Python

Ahoy! Todas as mensagens transmitidas pelos canais de mensagens da Twilio são tratadas como mensagens A2P (Application-to-person, mensagem de aplicativo para pessoa) e estão sujeitas à Política de mensagens da Twilio. Para obter informações detalhadas sobre as regras de política para garantir conformidade ao usar os serviços da Twilio, consulte a Política de uso aceitável.

Com apenas algumas linhas de código, seu aplicativo Python pode enviar mensagens SMS com o Twilio Programmable Messaging.

Este início rápido do Programmable Messaging guiará você por todo o processo passo a passo, começando com a configuração de sua conta da Twilio até o fim, enviando um SMS usando um Messaging Service (Serviço de mensagens).

Neste início rápido, você aprende a:

  • Inscreva‐se na Twilio e obtenha seu primeiro número de telefone habilitado para SMS
  • Configure seu ambiente de desenvolvimento para enviar mensagens de saída
  • Enviar seu primeiro SMS de saída
  • Configure seu primeiro Twilio Messaging Service (Serviço de mensagens)
  • Envie um segundo SMS a partir desse Messaging Service (Serviço de mensagens)

Ao final deste início rápido, você terá uma base sólida para a criação e o dimensionamento com o Programmable Messaging da Twilio para seus casos de uso específicos.

Mostre‑me como se faz!

Inscreva‐se ou entre na Twilio

Já tem uma conta Twilio? Vá em frente e pule esta seção.

Você pode se inscrever em uma conta gratuita de avaliação da Twilio aqui.

  • Quando você se inscreve, a Twilio solicita a verificação do seu número de telefone pessoal. Isso ajuda a Twilio a verificar sua identidade e também permite o envio de mensagens de teste para seu telefone a partir de sua conta da Twilio enquanto estiver no modo de avaliação.
  • Depois de verificar seu número, você receberá uma série de perguntas para personalizar sua experiência.
  • Assim que passar pelo fluxo de criação, você chegará ao dashboard do projeto no Twilio Console. É aqui que você poderá acessar o Account SID (SID da conta), o token de autenticação, encontrar um número de telefone da Twilio e muito mais.
Eu tenho uma conta! O que vem a seguir?

Instalar a CLI da Twilio

Usaremos a CLI (interface de linha de comando) da Twilio para algumas tarefas, então vamos instalá‐la em seguida.

A maneira sugerida para instalar o twilio-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 de instalar o Homebrew, execute o seguinte comando para instalar o twilio-cli:

brew tap twilio/brew && brew install twilio

A maneira sugerida para instalar o twilio-cli é usando Scoop, um instalador de linha de comando para Windows. Se ainda não o tiver instalado, visite o site do Scoop para obter instruções de instalação e, em seguida, retorne aqui.

Observação: o PowerShell precisará ser executado como administrador para evitar problemas comuns de permissão ao instalar pelo Scoop.

  1. Adicione o Bucket da twilio-cli:
    scoop bucket add twilio-scoop https://github.com/twilio/scoop-twilio-cli
  2. Instale o aplicativo:
    scoop install twilio​

O twilio-cli pode ser instalado usando a Advanced Package Tool (apt) na maioria das distribuições, como Debian, Ubuntu e Mint.

Para isso, execute os seguintes comandos no seu terminal:

wget -qO- https://twilio-cli-prod.s3.amazonaws.com/twilio_pub.asc \
  | sudo apt-key add -
sudo touch /etc/apt/sources.list.d/twilio.list
echo 'deb https://twilio-cli-prod.s3.amazonaws.com/apt/ /' \
  | sudo tee /etc/apt/sources.list.d/twilio.list
sudo apt update
sudo apt install -y twilio

Para outros métodos de instalação, consulte o início rápido Twilio CLI.

Execute twilio login para conectar a CLI da Twilio à sua conta. Acesse https://www.twilio.com/console e você encontrará o Account SID (SID da conta) exclusivo e o Auth Token (Token de autenticação) para fornecer à CLI.

Você pode revelar seu Auth Token (Token de autenticação) clicando no ícone de olho:

Reveal Your Auth Token

Agora para obter um número de telefone...

Adquira um número de telefone

Se você não possui atualmente um número de telefone Twilio com funcionalidade SMS, precisará adquirir um. Na CLI, execute:

twilio phone-numbers:buy:local --country-code US --sms-enabled

Substitua US pelo seu código de país ISO-3166-1 se desejar um número de telefone em outro país. Se você não estiver encontrando nenhum número habilitado para SMS, tente procurar um número de celular em vez de um número local: twilio phone-numbers:buy:mobile --country-code DE --sms-enabled

Selecione um número de telefone para adicioná‐lo à sua conta.

Em seguida, precisamos instalar o Python e a biblioteca auxiliar Twilio Python.

Sem problemas! Leve‑me até a configuração.

Instale o Python e a biblioteca auxiliar da Twilio

Se você já passou por outro de nossos inícios rápidos do Python e já tem o Python e a biblioteca auxiliar da Twilio Python instalada, você pode pular esta etapa e ir direto para o envio da primeira mensagem de texto.

Para enviar seu primeiro SMS, você precisará ter o Python e a biblioteca auxiliar Twilio Python já instalada.

Instale o Python

Se você estiver usando uma máquina Mac ou Linux, provavelmente já tem o Python instalado. Você pode verificar isso abrindo um terminal e executando o seguinte comando:

python --version

Você deve ver algo como:

$ python --version
Python 3.4

Os usuários do Windows podem seguir este excelente tutorial para instalar o Python no Windowsou seguir as instruções de documentação do Python.

O SDK de servidor Twilio Python é compatível com Python 2 e Python 3. Você pode usar qualquer uma das versões para este início rápido, mas recomendamos usar Python 3 para projetos futuros com a Twilio, a menos que haja bibliotecas específicas necessárias ao seu projeto que sejam compatíveis apenas com Python 2.

Instale o SDK de servidor Twilio Python

A maneira mais fácil de instalar a biblioteca é usando o pip, um gerenciador de pacotes para Python que facilita a instalação das bibliotecas necessárias. Basta executar isso no terminal:

pip install twilio

Se você receber um erro pip: command not found, também poderá usar o comando easy_install executando‐o em seu terminal:

easy_install twilio

Se preferir instalar manualmente, você pode baixar o código‐fonte (ZIP) para o twilio-python e instalar a biblioteca executando:

python setup.py install

na pasta que contém o código da biblioteca twilio-python do SDK de servidor.

Tudo pronto! Vamos enviar uma mensagem de texto.

Enviar um SMS de saída com Python

Agora que temos o Python e o twilio-python instalados, podemos enviar uma mensagem de texto de saída do número de telefone da Twilio que acabamos de adquirir com uma única solicitação de API. Crie e abra um novo arquivo chamado send_sms.py e digite ou cole neste exemplo de código.

        
        
        
        Esse código cria uma nova instância do recurso de mensagem e envia um HTTP POST para o URI do recurso de mensagem.

        Enviar um SMS usando a Twilio

        Esse código cria uma nova instância do recurso de mensagem e envia um HTTP POST para o URI do recurso de mensagem.

        Você precisará editar seu arquivo send_sms.py um pouco mais antes que sua mensagem seja enviada:

        Substitua os valores do espaço reservado para a credencial

        Substitua os valores de espaço reservado para account_sid e auth_token por suas credenciais pessoais da Twilio. Acesse https://www.twilio.com/console e faça login. Nesta página, você encontrará o Account SID (SID da conta) exclusivo e o Auth Token (Token de autenticação), que é necessário sempre que enviar mensagens pelo Twilio Client dessa forma. Você pode revelar seu Auth Token (Token de autenticação) clicando no link "view" (exibir):

        Reveal your Auth Token in the Twilio Console

        Abra o arquivo send_sms.py e substitua os valores account_sid e auth_token por seus valores exclusivos.

        Observação: não há problema em codificar suas credenciais ao começar, mas você deve usar variáveis de ambiente para mantê‐las secretas antes de implantar na produção. Confira como definir variáveis de ambiente para obter mais informações.

        Substitua o from_ phone number

        Você se lembra do número de telefone habilitado para SMS que você adquiriu há apenas alguns minutos? Vá em frente e substitua o from_ (de) número existente por aquele, lembrando de usar a formatação E.164:

        [+][código do país][número de telefone, incluindo o código de área]

        Substituir o "to" (para) número de telefone

        Substitua o to número de telefone pelo seu número de telefone celular. Pode ser qualquer número de telefone que possa receber mensagens de texto, mas é uma boa ideia testar com o seu próprio telefone para que possa ver a magia acontecer! Como acima, você deve usar a formatação E.164 para esse valor.

        Se você estiver em uma conta de avaliação da Twilio, suas mensagens SMS enviadas serão limitadas a números de telefone que você verificou com a Twilio. Os números de telefone podem ser verificados por meio dos IDs de autor da chamada verificados no Twilio Console.

        Quando você enviar um SMS a partir do seu número de telefone de avaliação gratuita, ele sempre começará com "Sent from a Twilio trial account" (Enviado de uma conta de avaliação gratuita da Twilio). Removemos esta mensagem após a atualização.

        Salve suas alterações e execute este script a partir do seu terminal:

        python send_sms.py

        É isso! Em alguns momentos, você deve receber um SMS do seu número Twilio em seu telefone.

        Seus clientes estão nos EUA ou no Canadá? Você também pode enviar mensagens MMS adicionando apenas uma linha de código. Confira este guia para enviar MMS e veja como isso é feito.

        Neste exemplo de código, estamos fazendo uma solicitação POST para o endpoint de mensagem da API do Programmable Messaging para criar uma nova mensagem de saída. Estamos usando a biblioteca twilio-python com o método integrado create, mas você pode fazer essa solicitação usando a CLI da Twilio (que você já instalou), curl ou um módulo de solicitação de sua escolha.

        Confira os exemplos de código para enviar um SMS com a CLI da Twilio e o curl. Não se esqueça de atualizar os parâmetros body, to (para) e from (de)!

              
              
              
              Este exemplo de código faz uma solicitação ao recurso de mensagem usando a CLI da Twilio

              Use a CLI da Twilio para enviar um SMS

              Este exemplo de código faz uma solicitação ao recurso de mensagem usando a CLI da Twilio
                    
                    
                    
                    Este exemplo de código faz uma solicitação ao recurso de mensagem usando o curl

                    Use o curl para enviar um SMS

                    Este exemplo de código faz uma solicitação ao recurso de mensagem usando o curl
                    Recebi a mensagem. O que vem a seguir?

                    Configurar um Twilio Messaging Service (Serviço de mensagens)

                    Parabéns, você enviou seu primeiro SMS com o Twilio Programmable Messaging e recebeu em seu dispositivo pessoal.

                    Neste ponto, adquirimos um número de telefone da Twilio e o usamos para enviar um SMS de saída. Você pode imaginar um momento em um futuro não tão distante, em que precisará de uma maneira mais robusta e repleta de recursos para enviar mensagens, como:

                    • enviar muitas mensagens em um curto período
                    • lidar com opt-ins e opt-outs
                    • garantir que seus clientes sempre recebam uma experiência de mensagens consistente com o mesmo número de telefone.

                    Na próxima parte do início rápido, veremos como configurar seu primeiro Messaging Service (Serviço de mensagens). Você pode pensar em um Messaging Service (Serviço de mensagens) como um contêiner para armazenar todos os seus números de telefone disponíveis (e outros remetentes) e que vem com recursos que você pode precisar durante a jornada de mensagens.

                    Criar um Messaging Service (Serviço de mensagens) com número de telefone

                    Execute o seguinte comando da CLI da Twilio para criar um Messaging Service (Serviço de mensagens) que usaremos para enviar nosso primeiro SMS programável.

                    twilio api:messaging:v1:services:create --friendly-name "My first Messaging Service"

                    Anote o SID do Messaging Service (Serviço de mensagens), ele começa com "MGXXX...". Precisamos enviar nossa próxima mensagem.

                    Em seguida, adicione o número de telefone que acabou de adquirir. Esqueceu o número já? Não se preocupe, você pode listá‐lo com a CLI da Twilio:

                    twilio phone-numbers:list
                    # Grab the SID ("PNXXXX...") of your number

                    Adicione seu número de telefone ao Messaging Service (Serviço de mensagens) recém‐criado com o seguinte comando:

                    twilio api:messaging:v1:services:phone-numbers:create --service-sid MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX --phone-number-sid PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                    
                    OK, estou pronto para enviar do meu serviço.

                    Envie um SMS do seu Messaging Service (Serviço de mensagens)

                    O envio de um SMS de saída de um Messaging Service (Serviço de mensagens) é semelhante ao envio de um número de telefone da Twilio individual. A principal diferença é substituir o parâmetro from_ (de) pelo messaging_service_sid para indicar que você está enviando de um número de telefone dentro do pool de remetentes do Messaging Service (Serviço de mensagens). (Atualmente, há apenas um número de telefone no seu pool de remetentes, então enviaremos desse número.)

                          
                          
                          
                          Esse código cria uma nova instância do recurso de mensagem, desta vez com um parâmetro Messaging_Service_sid

                          Envie um SMS usando um Messaging Service (Serviço de mensagens)

                          Esse código cria uma nova instância do recurso de mensagem, desta vez com um parâmetro Messaging_Service_sid

                          Substitua o parâmetro Messaging_Service_sid

                          Você se lembra do Messaging Service (Serviço de mensagens) que acabou de criar? Em vez do parâmetro from_ (de) e do número de telefone, use o parâmetro messaging_service_sid com o SID do Messaging Service (Serviço de mensagens) "MGXXXX...". Salve suas alterações e execute este script a partir do seu terminal:

                          python send_sms.py

                          E isso serve para enviar um SMS usando o Twilio Messaging Service (Serviço de mensagens)! Em alguns segundos, você deve receber outro SMS no seu número de telefone da Twilio. O Messaging Service (Serviço de mensagens) selecionou perfeitamente seu número do pool de remetentes para enviar essa segunda mensagem de saída.

                          Funcionou! Tudo pronto: o que vem a seguir?

                          Para onde ir em seguida?

                          Agora que você enviou suas primeiras mensagens SMS, confira os seguintes recursos para continuar sua jornada de mensagens com a Twilio:

                          Estamos ansiosos para ver o que você vai criar!

                          Classifique esta página:

                          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.

                                
                                
                                

                                Obrigado pelo seu feedback!

                                Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

                                Enviando seu feedback...
                                🎉 Obrigado pelo seu feedback!
                                Algo deu errado. Tente novamente.

                                Obrigado pelo seu feedback!

                                thanks-feedback-gif