Una tienda puede notificar a muchos clientes sobre el mismo evento y personalizar cada texto. Cada destinatario sigue necesitando permiso y una ruta de entrega válida.
¿Qué cambia cuando envío a muchos destinatarios?
Coordinas muchos envíos independientes en lugar de tratar una sola solicitud como la campaña completa.
Cada destinatario puede tener un destino diferente, un requisito de remitente o un estado de consentimiento distinto. Una entrega exitosa a una persona no dice nada sobre el teléfono de otra.
La personalización también cambia el texto final. Un nombre más largo o un emoji pueden cambiar la codificación y el recuento de segmentos. Cuenta los cuerpos completados al estimar el volumen facturable.
¿Debo usar una difusión o lotes de API?
Usa una difusión para coordinar una campaña en torno a una audiencia, contenido compartido y un calendario de envío. Usa lotes para enviar mensajes independientes desde tu aplicación.
El flujo de campaña de SMS conecta la preparación de audiencia, la personalización, la revisión de lanzamiento y los resultados por destinatario. El endpoint de lotes ofrece una operación más reducida: aceptar solicitudes individuales juntas.
Un identificador de lote no reemplaza la gestión de campaña, los registros de consentimiento ni un calendario.
¿Cómo acepta Bird un lote?
Envías entre 1 y 100 mensajes independientes a través de POST /v1/sms/batches.
Coloca cada objeto de mensaje en el array messages. Una campaña con 250 destinatarios necesita al menos tres solicitudes porque cada lote admite como máximo 100 elementos.
Bird valida cada elemento antes de poner en cola cualquiera. Un mensaje inválido hace que toda la solicitud falle con 422. Corrige el elemento inválido antes de reenviar el lote.
Si la solicitud es exitosa, data contiene los mensajes aceptados en orden de envío. summary.accepted_count reporta la cantidad aceptada. La referencia del lote documenta esa respuesta.
Mantén cada identificador de mensaje devuelto asociado a su destinatario. Los eventos de entrega posteriores pertenecen a esos mensajes individuales, no a un resultado compartido del lote.
¿Un lote exitoso significa que todos recibieron el texto?
Una respuesta 202 significa que Bird aceptó los mensajes para procesarlos.
El cobro, el envío al operador y la entrega ocurren después. Un mensaje aceptado puede fallar mientras otros llegan a sus destinatarios. Actualiza la campaña a partir de los eventos de entrega de cada mensaje.
No reenvíes un lote aceptado completo porque un destinatario falló. Investiga el error de ese mensaje. Decide si un intento separado es apropiado.
¿Cómo debo estimar el tiempo de envío?
Estima cada destino por separado usando los límites y la capacidad que aplican a su ruta de envío.
Un límite de solicitudes de API controla qué tan rápido envías trabajo. El rendimiento de entrega controla una etapa posterior. Aumentar la concurrencia de envío no puede eliminar el límite de un operador.
Verifica la unidad antes de calcular la capacidad. Un límite basado en segmentos cuenta un texto multiparte más de una vez. Un límite basado en solicitudes cuenta la llamada del lote en su lugar.
Bird asigna las solicitudes de lote a sms_batch, de forma separada de los envíos individuales bajo sms_send. La guía de limitación de solicitudes explica esas políticas de solicitudes. El rendimiento de SMS explica la cuestión de entrega por separado.
¿Qué debo verificar antes de lanzar la campaña?
Verifica el consentimiento, la elegibilidad del remitente y el mensaje completado para cada destinatario.
Usa el estado de exclusión más reciente al liberar trabajo en cola. Una lista exportada anteriormente puede incluir a alguien que desde entonces retiró su permiso.
Verifica los requisitos de remitente del destino antes de agrupar a sus destinatarios en un lote. De lo contrario, un elemento inválido puede rechazar un lote que contiene muchos mensajes válidos.
Comienza con un grupo reducido. Inspecciona los resultados devueltos antes de ampliar el envío. Eso facilita detectar un remitente o mensaje erróneo antes de que llegue a toda la lista.
- Aplica las reglas del destino y el permiso de cada destinatario.
- Valida los cuerpos completados.
- Cuenta sus segmentos.
- Envía los lotes dentro de los límites de solicitudes.
- Rastrea los resultados de entrega por mensaje. Investiga cada fallo por separado.
En resumen
Cada destinatario sigue teniendo un mensaje independiente.
La aceptación del lote no hace que todos los destinatarios compartan un mismo resultado de entrega.
Un lote de Bird contiene como máximo 100 mensajes.
Usa lotes para envíos independientes de API. Una difusión a audiencia gestiona el flujo de campaña coordinado.
La validación se aplica a todo el lote.
Un elemento inválido hace que Bird rechace la solicitud antes de poner en cola cualquier elemento.
El consentimiento y la elegibilidad del remitente siguen siendo verificaciones individuales.
Vuelve a verificar el permiso y los requisitos de destino al liberar cada parte de una campaña.