Enviar mensagens com o Twilio
Made by Twilio
Envia uma mensagem usando a API Twilio com base no conteúdo de um documento gravado em uma coleção especificada do Cloud Firestore.
Como esta extensão funciona
Use esta extensão para enviar mensagens (SMS ou WhatsApp) usando a API Twilio Programmable Messaging com base nas informações de documentos adicionados a uma coleção especificada do Cloud Firestore. A extensão também registra o status de entrega de cada mensagem.
Adicionar um documento aciona esta extensão para enviar uma mensagem criada a partir dos campos do documento. Os campos do documento especificam para quem a mensagem será enviada e o corpo da mensagem, e opcionalmente podem definir o número a partir do qual a mensagem será enviada.
Veja um exemplo de documento que acionaria esta extensão:
admin.firestore().collection('messages').add({ to: '+15551234567', body: 'Hello from Firebase!' });
Campos obrigatórios
Campo | Descrição |
---|---|
to |
O número de telefone ou do WhatsApp para o qual você quer enviar a mensagem. Os números de telefone precisam estar no formato e.164. |
body |
O corpo da mensagem |
Campos opcionais
Campo | Descrição |
---|---|
from |
Um número de telefone do Twilio ou serviço de mensagem que você quer usar para enviar a mensagem. Substitui o número de envio ou serviço de mensagens definido nas configurações da extensão |
Outras configurações
Antes de instalar a extensão, verifique se:
- Você configurou um banco de dados do Cloud Firestore no projeto do Firebase
- Você se inscreveu para uma conta do Twilio
Como enviar mensagens SMS
- Você precisa de um número de telefone do Twilio que possa enviar mensagens SMS
- Se você estiver usando uma conta de teste, só poderá enviar mensagens para um número que você verificou com o Twilio
Como enviar mensagens do WhatsApp
- Você pode testar com o número fornecido no sandbox do Twilio para WhatsApp
- Para enviar mensagens do WhatsApp em produção, é preciso conectar um número do Twilio a um perfil do WhatsApp Business
Faturamento
Para instalar uma extensão, seu projeto precisa estar no plano Blaze, com pagamento por utilização
- Um pequeno valor será cobrado de você (geralmente cerca de US$ 0,01/mês) referente aos recursos do Firebase exigidos pela extensão, mesmo se não forem usados.
- Esta extensão usa outros serviços do Firebase e do Google Cloud Platform, que têm cobranças associadas caso o nível sem custos seja excedido:
- Cloud Firestore
- Cloud Functions (ambiente de execução Node.js 10+. Consulte as perguntas frequentes)
- Cloud Secret Manager
O uso desta extensão também exige que você tenha uma conta do Twilio e credenciais para usar a API Twilio para a entrega de mensagens. Os custos associados ao uso desse serviço são responsabilidade sua.
Como instalar a extensão
Como usar o Console do Firebase
Para instalar e gerenciar extensões, use o Console do Firebase.
Instalar usando o consoleComo usar a Firebase CLI
Para instalar e gerenciar extensões, também é possível usar a Firebase CLI:
Etapa 1: execute o comando npm (em inglês) a seguir para instalar a CLI ou atualizá-la para a versão mais recente.
npm install -g firebase-toolsNão está funcionando? Consulte a referência da Firebase CLI ou altere suas permissões do npm (em inglês).
Etapa 2: configurar um novo diretório do projeto no Firebase ou acessar um já configurado
Etapa 3: adicionar esta extensão ao seu manifesto de extensões ao ser executada
firebase ext:install twilio/send-message --local --project=projectId_or_alias
Etapa 4 (opcional): testar a extensão localmente usando o Pacote de emuladores do Firebase
firebase emulators:start
Etapa 5: implantar as extensões do seu manifesto ao projeto
firebase deploy --only extensions --project=projectId_or_alias