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 mensagens que você quer usar para enviar a mensagem. Substitui o número do remetente ou o serviço de mensagens definido nas configurações da extensão |
mediaUrls
|
Uma matriz de URLs de mídia para enviar com a mensagem. Suportado apenas nos EUA e no Canadá. Veja os documentos sobre como criar uma mensagem para mais informações. |
Outras configurações
Antes de instalar esta extensão, confira o seguinte:
- Você configurou um banco de dados do Cloud Firestore no seu projeto do Firebase
- Você se inscreveu em uma conta do Twilio
Como enviar SMS
- Você precisará de um número de telefone do Twilio que seja capaz de enviar mensagens SMS.
- Se estiver usando uma conta de teste, você só poderá enviar mensagens para um número que você verificou com Twilio
Como enviar mensagens do WhatsApp
- Você pode testar com o número fornecido no Twilio Sandbox para WhatsApp WhatsApp/sandbox)
- Para enviar mensagens do WhatsApp em produção, é necessário conectar um número do Twilio a um Perfil da Empresa no WhatsApp
Faturamento
Para instalar uma extensão, o projeto precisa estar no plano Blaze (pagamento por utilização)
- Você receberá uma pequena cobrança (normalmente cerca de US$ 0,01/mês) pelos recursos do Firebase exigidos por essa extensão (mesmo que ela não seja usada).
- Esta extensão usa outros Firebase e Google Cloud Platform serviços, que têm cobranças associadas ao exceder o nível sem custos do serviço:
- Cloud Firestore
- Cloud Functions (Tempo de execução do 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 de sua responsabilidade.
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
Step 4 (Optional): Test this extension locally with the Firebase Emulator Suite
firebase emulators:start
Etapa 5: implantar as extensões do seu manifesto ao projeto
firebase deploy --only extensions --project=projectId_or_alias