Início rápido do Programmable Messaging PHP
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.
Em algumas linhas de código, seu aplicativo PHP pode enviar, receber e responder mensagens de texto com o Twilio Programmable SMS.
Este Início rápido de SMS em PHP mostra como usar nossaAPI REST Communications, a CLI da Twilio e a biblioteca auxiliar Twilio PHP.
Usaremos o gerenciador de pacotes Composer para gerenciar nossas dependências de produtos. Se você não quiser usar o Composer, não há problema, também temos um Início rápido de SMS em PHP sem Composer.
Neste início rápido, você aprenderá a:
- Inscrever‐se na Twilio e adquirir um número de telefone habilitado para SMS.
- Verificar e instalar todos os pré‐requisitos usando o Composer.
- Enviar seu primeiro SMS.
- Configurar seu ambiente de desenvolvimento para enviar e receber mensagens.
- Receber mensagens de texto de entrada.
- Responder mensagens recebidas com uma mensagem SMS de retorno.
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.
Instalar a CLI da Twilio
Precisaremos usar 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.
- Adicione o Bucket da
twilio-cli
:
scoop bucket add twilio-scoop https://github.com/twilio/scoop-twilio-cli
- 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:
Adquira um número de telefone
Se você não possuir um número de telefone Twilio com funcionalidade SMS, terá de 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 recebendo 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 PHP e a biblioteca auxiliar Twilio PHP.
Instale o PHP e a biblioteca auxiliar do Twilio PHP
Se você já tem o PHP e a biblioteca auxiliar do Twilio PHP instalada em seu diretório de trabalho, sinta‐se à vontade para pular esta etapa e continuar enviando sua primeira mensagem de texto.
Para enviar seu primeiro SMS, vamos certificar‐se de que você está com PHP configurado e pode instalar a biblioteca auxiliar Twilio PHP. Ao desenvolver para Web no PHP, sugerimos enfaticamente o uso do Composer para o gerenciamento de pacotes. Este Início rápido depende do Composer para instalar a biblioteca auxiliar do PHP. Se você optar por não usar o Composer, visite Início rápido de SMS em PHP sem Composer.
Instale o PHP
Se você estiver usando um Mac ou uma máquina *nix, provavelmente já tem o PHP instalado. Execute no seu terminal favorito:
php --version
Se ele não estiver instalado, siga as instruções de instalação do PHP.
Se você estiver usando uma máquina Windows, siga o tutorial oficial para instalar o PHP.
Embora muitas versões do PHP 5.x e PHP 7.x funcionem para este Início rápido, preste atenção às versões suportadas do PHP. Sempre atualize versões sem suporte ao desenvolver para Web, pois versões mais antigas não recebem atualizações de segurança.
Instale o Composer
Composer é o gerenciador de pacotes padrão de fato para o desenvolvimento web em PHP. Se você ainda não o instalou, veja as instruções de instalação para sua plataforma:
Se você preferir instalar dependências manualmente, confira Início rápido de SMS em PHP sem Composer.
Instale a biblioteca auxiliar Twilio PHP
Precisamos instalar a biblioteca auxiliar Twilio PHP no diretório onde você concluirá o Início rápido. Se você estiver usando o Composer, há duas maneiras de fazer isso.
Primeiro, a partir de um terminal, você pode executar o seguinte comando:
composer require twilio/sdk
Como alternativa, você pode criar um arquivo chamado composer.json
e, em seguida, adicionar o seguinte a ele:
{
"require": {
"twilio/sdk": "^5.0"
}
}
Em seguida, execute
composer install
E o composer irá pegar a versão mais recente da biblioteca auxiliar Twilio PHP.
Finalmente, para uma instalação sem composer , siga estas instruções. Você também precisará alterar os exemplos de código conforme eles aparecem neste Início rápido, como mostrado nessas instruções.
Enviar um SMS de saída com PHP
Agora que temos o PHP, o Composer e o twilio-php
instalados, podemos fazer uma única solicitação de API e enviar uma mensagem de texto de saída do nosso número de telefone Twilio. Crie e abra um novo arquivo chamado send_sms.php
e digite ou cole neste exemplo de código.
Substitua o espaço reservado pelas credenciais da Twilio
Troque os espaços reservados account_sid
e auth_token
pelas suas credenciais pessoais da Twilio. Substitua os valores account_sid
e auth_token
por seus valores exclusivos.
Embora seja mais fácil codificar suas credenciais em um arquivo para este Início rápido, você deve usar variáveis de ambiente para mantê‐las em segredo na produção. Confira como definir variáveis de ambiente para mais informações e veja os comentários do código para ver um exemplo de como lê‐las em PHP. Esse repositório também é um excelente recurso para lidar com variáveis de ambiente.
Substitua o número de telefone twilio_Number
Anteriormente, você adquiriu um número de telefone habilitado para SMS. Cole esse número na variável twilio_number
usando a formatação E.164:
[+][código do país][número de telefone, incluindo o código de área]
Substitua o 'To' (Para) número em criar() chamada
O primeiro valor na chamada para create()
é o número de telefone de saída, atualmente definido como +15558675310
. Este pode ser qualquer número de telefone que possa receber mensagens de texto, mas você deve usar um número que você controla primeiro para acompanhar a magia! Conforme acima, use a formatação E.164 para esse número.
Salve o arquivo e execute o script:
php send_sms.php
Bum! Supondo que todos os valores estejam corretos, você já deve ver o 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 fazer isso.
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 chamador verificados do Twilio Console.
Receber e responder mensagens SMS de entrada com PHP
Quando alguém envia um SMS para o número de telefone da Twilio, a Twilio faz uma solicitação HTTP POST
para o seu servidor solicitando instruções sobre o que fazer em seguida. Para este Início rápido, responderemos ao remetente com uma nota sobre como estamos enviando nossa resposta por SMS.
Vamos usar novamente a Biblioteca PHP da Twilio, depois usar o webserver de desenvolvimento integrado do PHP com o ngrok para instruir a Twilio a lidar com a mensagem. Crie um novo arquivo reply_sms.php
no mesmo diretório que send_sms.php
, abra‐o e copie e cole ou digite o código a seguir.
Se você não estiver usando o mesmo diretório como antes, siga a etapa de instalação da biblioteca auxiliar do PHP acima.
Salve o arquivo e inicie o servidor de desenvolvimento PHP com:
php -S localhost:8000
No seu navegador favorito, abra o URL http://localhost:8000/reply_sms.php.
Se tudo ocorreu bem, você deve ver o TwiML em seu navegador com a mensagem que gostaríamos de responder a todos os nossos textos de entrada. E, sim, esse é todo o código de que você precisa. Mas há apenas mais um passo que você precisa executar antes que tudo esteja conectado.
Configurar o URL de webhook
Você precisa configurar seu número de telefone da Twilio para chamar o URL do seu webhook sempre que uma nova mensagem chegar. Basta executar este comando na CLI, substituindo o número de telefone pelo número de telefone da Twilio:
twilio phone-numbers:update "+15017122661" --sms-url="http://localhost:8000/reply_sms.php"
A CLI iniciará um túnel ngrok, para que a Twilio possa alcançar sua máquina de desenvolvimento, e aguarde pacientemente pelas mensagens de texto recebidas!
Teste seu aplicativo com um texto
Agora que tudo está em ordem, é hora de testar.
Envie uma mensagem de texto do seu celular para o número de telefone da Twilio. Você verá algumas coisas acontecerem muito rapidamente:
- Seu servidor de desenvolvimento PHP verá uma nova conexão.
- A Twilio encaminhará sua resposta como SMS!
Próximas etapas
Agora que você conhece os princípios básicos de enviar e receber mensagens de texto SMS e MMS com PHP, você pode querer verificar estes recursos:
- Nossa extensa documentação de referência de API para o Twilio SMS.
- Saiba como criar uma conversa SMS no PHP.
- Monitore o status de entrega de suas mensagens com o PHP.
- Experimente o TwilioQuest, nosso jogo interativo e individualizado que ensina como usar a Twilio.
Esperamos que você tenha gostado do início rápido e, definitivamente, mal posso esperar para ver o que você vai criar!
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.