Saltar al contenido principal

Audiencias y campañas de mensajes

Una audiencia es una lista de personas para toda la empresa. Una campaña de mensajes envía un mensaje, o una cadena ordenada de mensajes, a una o varias audiencias por SMS/MMS, WhatsApp, Telegram, Messenger, Instagram o correo electrónico. Ambas están en Campañas en la consola, junto a las campañas de voz, y ambas están disponibles mediante la API (/audiences, /contact-optouts, /message-campaigns).

nota

Esta página describe cómo se comporta el producto y qué exige el proveedor de cada canal. No es asesoría legal. El consentimiento que necesita depende de su país y de su negocio; consulte a su abogado.

Audiencias​

Una persona en una audiencia tiene un nombre y cualquiera de estos datos: un número de teléfono (almacenado como E.164, por ejemplo +15550100100), una dirección de correo electrónico, un id de chat de Telegram, un id de WhatsApp (los dígitos del teléfono cuando está vacío), ids de Messenger e Instagram con alcance de página, un idioma, una zona horaria, un país y campos personalizados que puede usar en las plantillas de mensajes ({plan}). Cada persona también lleva el consentimiento por canal: con aceptación o sin ella, cuándo y dónde se otorgó.

  • Nada implica consentimiento. Una persona tiene aceptación en un canal solo cuando usted la registra, con la fuente ("formulario web 2026-10", "pago en la tienda").
  • Un teléfono, una dirección de correo electrónico o un id de canal aparece una sola vez por audiencia.
  • Las listas de 100,000 personas o más se buscan y se paginan en el servidor; el consentimiento se puede registrar para muchas personas a la vez.
  • La misma persona en dos audiencias recibe un solo mensaje de una campaña que apunta a ambas (la identifica el teléfono; si no, la dirección de correo electrónico; si no, un id de canal).

Cómo agregar personas​

DesdeCómo
Un archivoCSV o Excel (.xlsx, .xls) con el asistente de importación (abajo)
El directorio de contactosImportar desde contactos: la libreta telefónica de la empresa o los contactos de un usuario que tengan un número o una dirección utilizable. Los contactos no incluyen consentimiento.
La bandeja de entradaImportar desde la bandeja: las personas que escribieron por Telegram, Messenger, Instagram y WhatsApp. Un número de WhatsApp se convierte en el teléfono de la persona. Un id de Telegram, Messenger o Instagram es una persona aparte hasta que vincule la conversación con una persona (la conversación de la bandeja se puede vincular a una entrada). Escribir no es dar consentimiento.
La APIPOST /audiences/{id}/entries para una persona, POST /audiences/{id}/import para un CSV pequeño

El asistente de importación​

  1. Cargue un archivo CSV o Excel. El archivo se transmite al servidor y nunca se mantiene en memoria. El límite lo fija el operador (predeterminado 512 MB, alrededor de un millón de filas o más); un archivo mayor se rechaza con MPBX-AUDIENCE-IMPORT-TOO-LARGE, y una empresa que excede su cuota de almacenamiento, con MPBX-STORAGE-QUOTA-EXCEEDED. En ninguno de los dos casos se almacena nada y nunca se elimina nada para hacer espacio.
  2. Vista previa. El asistente detecta la codificación (UTF-8, UTF-8 con BOM, Windows-1252) y el delimitador (coma, punto y coma, tabulador), muestra las hojas de un libro para que elija una, presenta el encabezado y las primeras filas, y propone la asignación de columnas. Si antes importó un archivo con el mismo encabezado, se propone la asignación que usó entonces.
  3. Asigne las columnas a los campos de una persona, a campos personalizados (field:plan) o a una columna de consentimiento (consent:sms, sí o no). También puede indicar que todos los del archivo aceptaron algunos canales; eso requiere la fuente, que se almacena junto con el consentimiento.
  4. Importe. Un trabajo en segundo plano lee el archivo en lotes de 2,000 filas con progreso en vivo (filas leídas, almacenadas, rechazadas, repetidas), que también se publica en el WebSocket de eventos como audience.import_progress. Puede cancelarlo; las personas ya almacenadas permanecen. El trabajo sobrevive a un reinicio del servidor y continúa donde se quedó. Las filas que repiten a una persona que ya está en la lista se omiten.
  5. Informe. Las filas rechazadas (teléfono o correo electrónico no válido, un número nacional sin país elegido, ninguna forma de contactar a la persona) se enumeran con el motivo y se pueden descargar como CSV junto con la fila tal como estaba en el archivo.

Plantillas. Descargue un CSV o XLSX vacío desde el asistente (o GET /audiences/import-template) con un encabezado para cada campo, una columna de consentimiento por canal, columnas field: para los campos personalizados que nombre y dos filas de ejemplo. Los encabezados (y, en el libro, una hoja de notas) están en su idioma; la importación los reconoce. Elimine las filas de ejemplo antes de importar.

Exclusiones​

Un único registro de no contactar atiende todos los canales. Una entrada es un canal (sms, whatsapp, telegram, messenger, instagram, email, voice o all) y un número, dirección o id.

Se llena porNotas
SMS STOP, UNSUBSCRIBE, CANCEL, END, QUIT (y las palabras localizadas)lo procesa el núcleo de SMS; se refleja aquí
STOP, UNSUBSCRIBE y las palabras localizadas como mensaje completo en WhatsApp, Telegram, Messenger, InstagramSTART devuelve a la persona
El enlace de cancelación de suscripción de los mensajes de campañaun clic, en el idioma del navegador, excluye a la persona del canal por el que llegó
"Presione 9" (la tecla de exclusión) en las llamadas salientes de IA y en la lista de no llamarlas entradas existentes de no llamar se movieron al registro; la lista de no llamar sigue funcionando
Administradorespágina Exclusiones o la API, con auditoría

Eliminar una entrada queda en la auditoría y solo debe hacerse cuando la persona pidió que se le contacte de nuevo. Las campañas consultan el registro antes de cada mensaje, también en las campañas que ya están en ejecución.

Campañas de mensajes​

Una campaña tiene:

  • Audiencias: una o varias; las personas se desduplican.
  • Pasos: cada uno con un canal y su contenido. Con más de un paso, los pasos posteriores son respaldos: por ejemplo, primero una plantilla de WhatsApp y después un SMS si la persona no está en WhatsApp o el mensaje no se entregó en 30 minutos.
  • Propósito: marketing (requiere consentimiento por canal) o transaccional (un recordatorio de cita, una actualización de entrega; el producto no exige consentimiento, pero las exclusiones se siguen aplicando).
  • Ventana de envío en la zona horaria de la persona (la de la entrada; si no, la de la campaña), con días de la semana; ritmo por minuto; reintentos de fallas temporales.
  • Plantillas con sustitución {field} y {field|default}, un texto por idioma elegido según el idioma de la persona, un contador de segmentos SMS (GSM de 7 bits, 160/153 caracteres por parte; UCS-2, 70/67), un asunto de correo electrónico y HTML con el enlace obligatorio {unsubscribe_url}, y para WhatsApp la plantilla aprobada con los valores de sus marcadores (elegida desde su cuenta de WhatsApp Business).
  • Ciclo de vida: borrador, programada, en ejecución, en pausa, detenida (final), terminada. Inicie, programe, pause, reanude y detenga desde la página.

Antes de iniciar, la campaña muestra a cuántas personas puede llegar por canal (personas con una dirección, el consentimiento que exige el propósito y sin exclusión) y, si configuró un precio por segmento de SMS, un límite superior del costo de los SMS. Mientras se ejecuta, ve en vivo los enviados, entregados, leídos, respondidos, fallidos, omitidos (y por qué: sin dirección, sin consentimiento, ventana cerrada, sin plantilla), excluidos y el costo real; las personas se pueden listar y exportar como CSV.

Una respuesta llega a la bandeja compartida como cualquier otro mensaje y se marca en la fila de la persona con un enlace a la conversación. El historial de la persona en las campañas (último contacto, resultado, cantidad) está en la persona.

Qué permite cada canal​

El programador aplica estas reglas a cada persona. A quien un canal no puede contactar se le omite, se cuenta y, si hay respaldo, pasa al siguiente paso. Las reglas siguientes son las de los propios proveedores; cambian, así que consulte las fuentes.

CanalRegla aplicada
WhatsAppFuera de la ventana de atención al cliente de 24 horas solo se puede enviar una plantilla aprobada, así que un paso de marketing necesita una. Dentro de la ventana (la persona escribió en las últimas 24 horas) se envía texto libre. Las plantillas de marketing requieren la aceptación de la persona, que es el consentimiento que usted registra. Los acuses de entrega y lectura llegan al webhook del canal. Fundamentos de las plantillas
TelegramUn bot solo puede escribir a las personas que lo iniciaron, así que solo se puede llegar a quienes tienen un id de chat (personas que escribieron al bot). El programador se mantiene por debajo de unos 25 mensajes por segundo para el bot (Telegram permite unos 30 por segundo en total, alrededor de uno por segundo por chat y 20 por minuto por grupo). Preguntas frecuentes sobre bots
Messenger e InstagramTexto libre solo dentro de la ventana de mensajería estándar de 24 horas. Las etiquetas de mensaje son para actualizaciones aprobadas no promocionales y nunca se usan en campañas; los mensajes promocionales fuera de la ventana requieren los productos propios de Meta (Sponsored Messages, notificaciones únicas), que aquí no se ofrecen. Los acuses de entrega nombran el mensaje; un acuse de lectura cubre todo lo enviado hasta su marca (Instagram nombra el mensaje visto). Política de Messenger Platform
SMS y MMSConsentimiento para marketing, exclusión por STOP respetada automáticamente, ventana de envío en la zona horaria del destinatario, costo por segmento contabilizado. Las reglas de operadores y países (registro del remitente, horas de silencio) siguen siendo de su responsabilidad: vea la guía de cumplimiento de SMS.
Correo electrónicoConsentimiento para marketing y el enlace de cancelación de suscripción en cada mensaje (se agrega si una plantilla lo omitió). Los mensajes llevan el enlace en el cuerpo y los encabezados List-Unsubscribe y List-Unsubscribe-Post de un clic (RFC 8058), que los proveedores de correo muestran como un botón de cancelar suscripción (SMTP, Amazon SES, SendGrid y Mailgun).
Apple Messages for Business, Google Business MessagesNo se ofrecen: responden a personas que escriben primero y no tienen campañas salientes.

Campañas de voz sobre audiencias​

Las campañas de marcación (agentes o blaster) y las campañas salientes de IA también llaman a audiencias: asocie una o varias listas a la campaña (PUT /campaigns/{id}/lists, PUT /ai/outbound/campaigns/{id}/lists) y cada persona con un número de teléfono se convierte en contacto (o trabajo) de la campaña, a menos que el número esté en el registro de no contactar para voz o para todos los canales. POST .../lists/sync agrega a las personas que se unieron a las listas desde entonces. La campaña conserva su propia cola de contactos (intentos, próximo intento, estado de la llamada); los contactos que existían antes, y los contactos agregados directamente, se movieron a una lista creada automáticamente por campaña ("Calls: ...", "AI calls: ..."), de modo que sus intentos ahora pertenecen a una persona.

  • Presione 9. La tecla de exclusión de una llamada de marcación o de IA escribe en el registro unificado; una entrada agregada ahí para voz es respetada por ambos tipos de campaña, y al quitarla se quita en todas partes.
  • Historial. Cada persona muestra las campañas que la contactaron: mensajes, llamadas de marcación y llamadas de IA, con el resultado y los intentos; el último contacto y la cantidad se conservan en la persona.

Modo de prueba​

Antes de una ejecución real, envíe una llamada de prueba o un mensaje de prueba a un destinatario de prueba. La prueba está en la página de la campaña y en su editor (Modo de prueba), para campañas de marcación y blaster, y, mediante la API, para campañas salientes de IA y campañas de mensajes.

  • Destinatario de prueba. Un número de teléfono en formato internacional (llamadas de prueba, SMS, WhatsApp), una dirección de correo electrónico y un id de chat de Telegram, un id de Messenger o un id de Instagram (elija los ids de los contactos de su bandeja). Defina un valor predeterminado de la empresa en Campañas, Destinatario de prueba de la empresa (settings:write); una campaña puede tener el suyo propio, campo por campo sobre el predeterminado (los campos vacíos usan el predeterminado).
  • Llamada de prueba (voz). Realiza una llamada real al número de prueba con exactamente la configuración de la campaña: el mensaje (texto hablado o grabación), la detección de contestadora y el mensaje en el buzón, las teclas de agente y de exclusión, el identificador de llamada y el plan de marcación de la extensión con sus reglas salientes y la protección contra fraude telefónico. Cuenta contra las llamadas simultáneas de la licencia como cualquier llamada de troncal. Una llamada a una cola de agentes (power, preview, predictive) lo conecta con un agente libre, exactamente como lo haría una llamada real. La página muestra la llamada en vivo (sonando, reproduciendo el mensaje, esperando una tecla) y su resultado. Presionar la tecla de exclusión durante una prueba informa opted out, pero no agrega su número a la lista de no contactar.
  • Enviar prueba (mensajes). Genera cada paso para una persona de muestra (su campo de nombre dice "Test Recipient"; los campos que la persona de prueba no tiene se muestran como [field]) y envía un mensaje por cada canal que marque, bajo las reglas del canal: WhatsApp fuera de la ventana de 24 horas se envía como la plantilla aprobada, Messenger e Instagram solo dentro de su ventana (de lo contrario la fila dice La ventana de respuesta de 24 horas está cerrada), y un canal que no está conectado o un paso que no escribió se omite con el motivo. Los asuntos de correo electrónico comienzan con [Test] y llevan un enlace de cancelación de muestra. La página muestra enviado, entregado y leído a medida que llegan los acuses.
  • Cuándo. Se puede probar una campaña en borrador, programada o en pausa. No se puede probar una campaña en ejecución, detenida o terminada (primero póngala en pausa). Las campañas salientes de IA no tienen estado de ejecución y siempre se pueden probar.
  • Seguridad. Una prueba va solo al destinatario de prueba almacenado: la dirección nunca se toma de la solicitud ni de una audiencia, y la audiencia no se lee ni se escribe. Los intentos de prueba se guardan en su propio registro, por lo que no entran en ninguna estadística de campaña, ni en el historial de contactos de una persona, ni en ninguna estimación o total del costo de SMS. El registro de no contactar se aplica: un destinatario de prueba que esté en él (para ese canal o para todos) se rechaza con un mensaje claro. Una campaña admite como máximo 10 intentos de prueba por hora. Cada prueba y cada cambio de un destinatario de prueba queda en el registro de auditoría.

Archivos grandes: configuración del servidor y del proxy​

El servidor lee dos ajustes de la sección [uploads] de su configuración:

[uploads]
max_import_bytes = 536870912 # the largest import file (default 512 MB)
import_timeout_secs = 3600 # how long one upload may take (default 1 hour)

Mantenga pequeño el límite de cuerpo del proxy para todo el sitio y aumente solo para la ruta de carga de importación (POST /api/v1/audiences/{id}/imports):

  • Caddy (el frontal del instalador): el Caddyfile incluido tiene un bloque para esa ruta con request_body { max_size 1GB } y tiempos de espera de lectura y escritura de una hora.
  • ingress-nginx (Kubernetes): un segundo Ingress para el mismo host, /api/v1/audiences/[0-9a-fA-F-]+/imports, con proxy-body-size: 1g, proxy-request-buffering: "off" y tiempos de espera de una hora (deploy/k8s/components/ingress/ingress.yaml).
  • Otro proxy: permita un cuerpo de al menos max_import_bytes en esa ruta, no almacene la solicitud en memoria y permita una hora de inactividad de lectura y escritura.