Envía mensajes con Twilio
Made by Twilio
Envía un mensaje usando la API de Twilio según el contenido de un documento escrito en una colección de Cloud Firestore especificada.
Cómo funciona esta extensión
Usa esta extensión para enviar mensajes (SMS o WhatsApp) con la API de mensajería programable de Twilio según la información de los documentos agregados a una colección de Cloud Firestore especificada. La extensión también registrará el estado de entrega de cada mensaje.
Si agregas un documento, esta extensión se activará para enviar un mensaje creado a partir de los campos del documento. Los campos del documento especifican a quién enviarle el mensaje y el cuerpo del mensaje, y pueden definir de manera opcional el número desde el cual enviar el mensaje.
Este es un ejemplo del documento que activaría esta extensión:
admin.firestore().collection('messages').add({ to: '+15551234567', body: 'Hello from Firebase!' });
Campos obligatorios
Campo | Descripción |
---|---|
to |
El número de teléfono o de WhatsApp al que quieres enviar el mensaje. Los números de teléfono deberían tener el formato e.164. |
body |
El cuerpo del mensaje |
Campos opcionales
Campo | Descripción |
---|---|
from |
Un número de teléfono de Twilio o un servicio de mensajería que quieras usar para enviar el mensaje. Anula el número con el que se llama o el servicio de mensajería establecido en la configuración de la extensión |
Configuración adicional
Antes de instalar esta extensión, asegúrate de lo siguiente:
- Tener configurada una base de datos de Cloud Firestore en tu proyecto de Firebase
- Haberte registrado en una cuenta de Twilio
Envía mensajes SMS
Necesitarás un número de teléfono de Twilio que pueda enviar mensajes SMS Si estás usando una cuenta de prueba, solo podrás enviar mensajes a un número que hayas verificado con Twilio
Envía mensajes de WhatsApp
- Puedes realizar pruebas con el número proporcionado en la zona de pruebas de Twilio para WhatsApp
- Para enviar mensajes de WhatsApp en producción, necesitarás conectar un número de Twilio a un Perfil de Negocio de WhatsApp
Facturación
Para instalar una extensión, tu proyecto debe tener el plan Blaze (prepago)
- Se te cobrará un importe pequeño (normalmente alrededor de $0.01 por mes) por los recursos de Firebase que se necesitan para esta extensión (incluso si no se usan).
- Esta extensión usa otros servicios de Firebase y Google Cloud Platform, que tienen cargos asociados si superas el nivel sin costo:
- Cloud Firestore
- Cloud Functions (entorno de ejecución de Node.js 10+; consulta las Preguntas frecuentes)
- Cloud Secret Manager
Para usar esta extensión también es necesario que tengas credenciales y una cuenta de Twilio a fin de usar la API de Twilio en la entrega de mensajes. Eres responsable de cualquier costo asociado al uso de Twilio.
Cómo instalar esta extensión
Usa Firebase console
Puedes usar Firebase console para instalar y administrar las extensiones.
Instala con consoleUsa Firebase CLI
También puedes usar Firebase CLI para instalar y administrar las extensiones.
Paso 1: Ejecuta el siguiente comando npm para instalar la CLI o actualizarla a la versión más reciente.
npm install -g firebase-tools¿No funciona? Consulta la referencia de Firebase CLI o cambia tus permisos de npm.
Paso 2: Configura un nuevo directorio de proyecto de Firebase o navega a uno existente
Paso 3: Agrega esta extensión al manifiesto de tu extensión ejecutando
firebase ext:install twilio/send-message --local --project=projectId_or_alias
Paso 4 (opcional): Prueba la extensión localmente con Firebase Emulator Suite
firebase emulators:start
Paso 5: Implementa las extensiones en el manifiesto de tu proyecto
firebase deploy --only extensions --project=projectId_or_alias