Una confirmación de pedido puede reutilizar su redacción y cambiar solo el número de pedido para cada destinatario. Eso mantiene el flujo de trabajo consistente mientras los datos cambian.
¿Qué contiene una plantilla?
Una plantilla contiene texto fijo, definiciones de variables y la categoría del mensaje, que clasifica el motivo del envío. Un destino puede aplicar esa clasificación de contenido a sus reglas de registro.
Cada variable nombra un valor que cambia entre envíos, como un número de pedido. La plantilla define su tipo aceptado, si es obligatorio y cualquier restricción sobre su valor.
El contenido y las plantillas de campaña combinan texto reutilizable con valores específicos de cada destinatario. El catálogo de plantillas de Bird incluye plantillas del sistema para mensajes de autenticación y transaccionales. Las plantillas del espacio de trabajo permiten publicar tu propio texto en varios idiomas. Se crean mediante la API de gestión de plantillas.
Lee las variables antes de elegir una plantilla. Una vista previa de aspecto familiar no garantiza que sus valores requeridos coincidan con los datos que tiene tu aplicación.
¿Las plantillas de SMS necesitan aprobación?
Las plantillas integradas están listas para enviar. Publicar una plantilla del espacio de trabajo valida su texto y sus variables. La versión publicada está disponible de inmediato, sin aprobación de Meta. Las reglas del destino aún pueden exigir el registro del contenido.
Son procesos separados. El cuerpo de mensaje reutilizable de un proveedor no establece por sí mismo el cumplimiento de las reglas de un destino.
Por ejemplo, la guía de TRAI para remitentes exige el registro de plantillas de contenido para comunicaciones a través de identidades de remitente registradas en India. Ese requisito se refiere a la estructura del mensaje, incluidas las partes fijas y variables.
Revisa el destino antes de elegir el flujo de envío. El registro de remitente se refiere a la identidad de envío y puede coexistir con un requisito de contenido.
¿Cómo elige Bird la categoría y el remitente?
La plantilla proporciona la categoría, que clasifica el contenido según el motivo del envío. Las plantillas integradas eligen un remitente para el destino; las del espacio de trabajo usan el remitente que indiques.
Un envío con plantilla rechaza text, category y media_urls junto con template. Omite from para una plantilla integrada y proporciónalo para una plantilla del espacio de trabajo. El contrato de envío con plantilla documenta estos requisitos.
Usa una plantilla del espacio de trabajo o texto libre cuando tu aplicación deba elegir un remitente concreto.
Inspecciona from y category en la respuesta. Esos campos te indican qué remitente y clasificación de contenido seleccionó Bird para ese mensaje.
¿Cómo envío una plantilla en Bird?
Identifica una plantilla publicada y proporciona los valores de sus variables en el objeto template del envío.
Usa slug o id para identificarla. Consulta GET /v1/sms/templates/{template_ref} para obtener su live_version_id y después GET /v1/sms/templates/{template_ref}/versions/{version_id} para ver el contenido y las definiciones de variables.
Coloca los valores en parameters, indexados por nombre de variable. Los valores requeridos faltantes, claves no declaradas o formatos inválidos devuelven 422, así que valida los valores antes de ejecutar el envío.
El objeto de parámetros serializado debe caber en 16 KB. Bird rechaza una solicitud que exceda ese límite, así que limítalo a los valores declarados de la plantilla.
Elige language cuando sea necesario. La configuración de idioma de la plantilla determina el valor predeterminado y cualquier alternativa, así que inspecciona esa configuración en lugar de asumir que todos los idiomas solicitados existen.
¿Las plantillas cambian cómo se factura SMS?
El texto renderizado se cuenta como cualquier otro cuerpo de SMS.
Inserta los valores reales antes de estimar los segmentos. Una referencia de pedido larga o un nombre fuera del alfabeto compacto puede aumentar la cantidad.
Una referencia a plantilla no es un precio fijo para cada destinatario. El campo segments.count de la respuesta reporta las partes facturables de ese mensaje renderizado.
¿Cuándo debo elegir una plantilla?
Elige una plantilla del catálogo cuando su cuerpo, variables y comportamiento de selección de remitente se ajusten a tu flujo de trabajo.
- Usa una plantilla cuando el cuerpo proporcionado coincida con el mensaje y tengas sus valores requeridos.
- Publica una plantilla del espacio de trabajo para reutilizar texto con tu propio remitente, o usa texto libre para un mensaje individual.
- Aplica los requisitos de registro del destino a cualquiera de las dos opciones.
En resumen
Las plantillas contienen texto reutilizable y definiciones de variables.
Elige una plantilla integrada o una plantilla publicada del espacio de trabajo y proporciona sus valores obligatorios.
La selección del remitente depende del ámbito de la plantilla.
Las plantillas integradas usan un remitente seleccionado por Bird. Las plantillas del espacio de trabajo requieren un remitente que te pertenezca. La plantilla proporciona la categoría.
Publicar en el espacio de trabajo no requiere revisión de Meta.
Publicar una plantilla del espacio de trabajo valida su borrador. La versión publicada está disponible de inmediato para enviar mensajes. Las reglas de registro de contenido del destino siguen siendo independientes.
Los valores sustituidos siguen afectando la cantidad de segmentos.
Revisa el mensaje renderizado porque valores más largos pueden aumentar los segmentos facturables.