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 Messaging para C# com .NET Framework

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.

Procurando o .NET Core? Também temos um início rápido para isso!

Com apenas algumas linhas de código, seu aplicativo .NET Framework pode enviar e receber mensagens de texto com o Twilio Programmable SMS.

Este Início rápido de SMS em C# ensinará como fazer isso usando nossa API REST Communications e a biblioteca auxiliar Twilio para .NET.

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

  1. Inscreva‐se na Twilio e obtenha seu primeiro número de telefone habilitado para SMS
  2. Configure seu ambiente de desenvolvimento para enviar e receber mensagens
  3. Como enviar seu primeiro SMS
  4. Receba mensagens de texto de entrada
  5. Responda mensagens recebidas com um SMS

Prefere começar assistindo a um vídeo? Confira nosso vídeo de Início rápido de SMS em C# no YouTube.

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

Precisaremos usar a CLI (interface de linha de comando) da Twilio para realizar 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 Visual Studio e a Biblioteca auxiliar Twilio C#.

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

Crie um novo projeto e adicione o pacote Twilio NuGet

Se você tem o Visual Studio instalado, já está pronto para começar. Caso contrário, você deverá fazer o download e instalá‐lo agora.

Depois de instalar o Visual Studio, abra‐o e crie um novo projeto de Console. Clique no botão "Create a new project" (Criar um novo projeto):

CS2019-Create-a-new-project.png

E, em seguida, escolha "Console App (.NET Framework)" (aplicativo de console [.NET Framework]) na lista de modelos de projeto:

VS2019-New-Console-Framework.png

Depois de instalar o Visual Studio, abra‐o e crie um novo projeto de Console. Selecione o menu "File" (Arquivo) e escolha "New" (Novo), "Project..." (Projeto...) e selecione "Console App (.NET Framework)" (aplicativo de console [.NET Framework]).

Visual Studio - New .NET Framework Project

Em seguida, selecione "Tools," (Ferramentas), "NuGet Package Manager" (Gerenciador de pacotes NuGet) e "Package Manager Console" (Console do gerenciador de pacotes) no menu principal do Visual Studio e digite este comando:

Install-Package Twilio
Tudo pronto! Vamos enviar uma mensagem de texto.

Enviar um SMS de saída com C#

Agora que temos o .NET e a biblioteca Twilio .NET instalados, podemos enviar uma mensagem de texto de saída do número de telefone da Twilio que acabamos de comprar com uma única solicitação de API. Abra o arquivo em seu novo projeto chamado Program.cs e digite ou cole neste exemplo de código, substituindo o código de modelo que já está lá.

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

        Enviar um SMS usando a Twilio com C#

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

        Você precisará editar esse arquivo 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 accountSid e authToken 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

        Edite o arquivo Program.cs e substitua os valores accountSid e authToken por seus valores exclusivos.

        Observação: não há problema em codificar suas credenciais ao começar, mas você deve usar a configuração para mantê‐las secretas antes de implantar na produção. Recomendamos o uso de variáveis de ambiente para armazenar seus segredos de usuário.

        Substituir o "from" (de) número de telefone

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

        Salve suas alterações e execute seu projeto no Visual Studio.

        É 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 tutorial de envio de MMS para ver como isso é feito.

        Enviei a mensagem! Como as recebo?

        Receber e responder mensagens SMS de entrada com o ASP.NET MVC

        Quando seu número Twilio recebe uma mensagem, a Twilio envia uma solicitação HTTP para um servidor que você controla. Esse mecanismo de retorno de chamada é conhecido como webhook. Quando a Twilio envia uma solicitação ao seu aplicativo, é esperado uma resposta no formato XML TwiML informando como responder à mensagem. Vamos ver como criaríamos isso no C# no usando ASP.NET MVC para .NET Framework.

        Crie um novo projeto MVC ASP.NET no Visual Studio

        No Visual Studio, clique em "Create a new project" (Criar um novo projeto):

        CS2019-Create-a-new-project.png

        Selecione "ASP.NET Web Application (.NET Framework)" na lista de modelos:

        VS2019-New-ASPNET-Framework.png

        Visual Studio 2019 0 Create a new ASP.NET Web Application

        Quando solicitado, escolha "MVC" como o tipo de projeto:

        No Visual Studio, selecione o menu "File" (Arquivo) e escolha "New" (Novo), "Project..." (Projeto...) e selecione "ASP.NET Web Application (.NET Framework)".

        Visual Studio - New ASP.NET MVC Project

        Em seguida, escolha o modelo "MVC".

        Visual Studio New ASP.NET Web Application (.NET Framework) - MVC

        Instalar o pacote Twilio.AspNet.Mvc

        Selecione "Tools," (Ferramentas), "NuGet Package Manager" (Gerenciador de pacotes NuGet) e "Package Manager Console" (Console do gerenciador de pacotes) no menu principal do Visual Studio e digite este comando:

        Install-Package Twilio.AspNet.Mvc -DependencyVersion HighestMinor

        Criar um novo controlador

        No diretório chamado Controllers, crie um novo controlador chamado SmsController.cs. (Clique com o botão direito do mouse na pasta Controllers, selecione "Add >" (Adicionar), "Controller..." (Controlador) e escolha o modelo "MVC 5 Controller - Empty".)

        Use o código a seguir para criar uma ação que possa manipular mensagens recebidas. Certifique‐se de usar todo o exemplo de código (observe, por exemplo, como o SmsController é herdado do TwilioController).

              
              
              
              Quando seu número de telefone recebe uma mensagem, a Twilio envia uma solicitação HTTP ao seu servidor. Este código mostra como seu servidor deve responder com uma mensagem de texto (usando TwiML).

              Responder a uma mensagem de texto recebida

              Quando seu número de telefone recebe uma mensagem, a Twilio envia uma solicitação HTTP ao seu servidor. Este código mostra como seu servidor deve responder com uma mensagem de texto (usando TwiML).

              No Visual Studio, execute o aplicativo (clique na seta verde "play" [executar]). Isso deve abrir um navegador da Web com a página de boas‐vindas do ASP.NET mostrando um URL como https://localhost:44360. OBSERVAÇÃO: o número da porta pode ser diferente de 44360. Você precisará deste URL na próxima etapa para conectar seu aplicativo ao número de telefone Twilio.

              Agora estou ficando animado - vamos conectar nosso código à Twilio!

              Configurar o URL de webhook

              Agora, você precisa configurar seu número de telefone Twilio para chamar o URL do webhook sempre que uma nova mensagem for recebida. Basta executar este comando CLI, substituir o número de telefone pelo seu próprio número de telefone Twilio e garantir que o URL tenha o número de porta correto:

              twilio phone-numbers:update "+15017122661" --sms-url="https://localhost:44360/sms"

              A CLI iniciará um túnel ngrok (para que a Twilio possa alcançar sua máquina de desenvolvimento) e aguardará pacientemente pelas mensagens de texto recebidas!

              Teste seu aplicativo com um texto

              Confirme se o seu projeto e o túnel ngrok está funcionando.

              Com ambos os servidores em execução, estamos prontos para a parte divertida: testar nosso novo aplicativo de SMS em ASP.NET!

              Envie um SMS do seu celular para o número de telefone Twilio configurado com este webhook. Seu aplicativo ASP.NET processará a mensagem de texto e você receberá sua resposta como SMS.

              Funcionou! Tudo pronto: o que vem a seguir?

              Para onde ir em seguida?

              Agora que você conhece os princípios básicos de envio e recebimento de mensagens de texto SMS e MMS com C# e .NET, talvez queira conferir esses recursos.

              Aproveite as dicas!

              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