Envíos Masivos `/send`¶

El comando /send le permite enviar mensajes individuales o cadenas de mensajes a clientes a través del sistema de envío. Se admiten todos los tipos principales de mensajes de Telegram: texto, stickers, voz, video, imágenes, archivos.

Cómo Funciona¶

La configuración y lanzamiento de envíos masivos se realiza en el tema General usando el comando /send. En temas de diálogo, el comando también puede ser usado por operadores, pero solo para enviar una plantilla preparada previamente al usuario o chat correspondiente.

El comando informa el inicio y finalización del envío, y después de completarse genera un informe en formato CSV con una lista de destinatarios y estado de entrega de mensajes.

Los mensajes de envíos no se muestran en temas para evitar interrumpir la cronología del tema y no exceder los límites disponibles de Telegram para entrega de mensajes a grupos con gran número de destinatarios.

Características Principales¶

Prueba fácil de envíos antes de enviar
Envío de mensajes privados a usuarios o a chats
Envío de mensajes únicos de cualquier tipo y cadenas de mensajes
Creación y uso de plantillas de envío
Configuración flexible de tiempo
Diferentes formas de especificar listas de destinatarios
Informe detallado de envío con estados de destinatarios
Velocidad actual de envío aproximadamente 1000 mensajes por minuto
En caso de error durante la ejecución del envío, se reinicia automáticamente desde el punto de parada en 2 minutos

Los envíos desde cuentas pueden llevar a prohibición

Con envíos masivos desde cuentas de usuario, existe un alto riesgo de obtener una prohibición temporal de Telegram si alguno de los destinatarios marca su mensaje como spam. Puede verificar restricciones de cuenta a través de @spambot

No hay tal riesgo con envíos de bots, pero los usuarios pueden dejar de recibir mensajes del bot en cualquier momento.

Opciones de Destinatarios¶

Envío de Prueba

La opción test envía mensaje solo a usted para verificar antes del envío masivo.
Todos los Usuarios

La opción all envía mensaje a todos los que tuvieron un diálogo a través de Hotline.
Lista desde Archivo

La opción file usa archivo adjunto con lista de user_id de destinatarios.
Lista en Comando

La opción list acepta lista de user_id directamente en el comando separados por comas.
Por Etiquetas

La opción mark envía mensaje a todos los usuarios con etiqueta especificada.

Ejemplos de Uso¶

Envío Rápido de Notificación¶

En tema General enviar mensaje: "¡Estimados clientes! Tenemos una nueva promoción en nuestro sitio web, ¡no se la pierda!"
Responder a él con comando: /send test (enviará mensaje de prueba al operador)
Verificar cómo se ve el mensaje (vendrá del bot o cuenta conectada)
Enviar a todos: /send all (como respuesta al mismo mensaje)

Idea de uso

De esta manera puede enviar rápidamente notas de video o mensajes de voz a la audiencia del bot, mejorando el compromiso del usuario.

Crear Plantilla con Cadena¶

En tema General enviar mensaje: "¡Hola! Gracias por su interés en nuestros servicios."
Responder a él con comando: /send onboarding (crea plantilla y coloca primer mensaje en ella)
Enviar otro mensaje en General: "Dentro de una hora le enviaremos información detallada."
Responder a él: /send onboarding 5m (agregar segundo mensaje a plantilla, que se enviará automáticamente 5 minutos después del primero)
Enviar PDF con catálogo y nota en General
Responder a él: /send onboarding 1h (agregar tercer mensaje a plantilla, que se enviará automáticamente 1 hora después del segundo)

Ahora la plantilla onboarding contiene tres mensajes con intervalos especificados, y puede usarse en temas de usuario con el comando /send onboarding o enviarse a todos los usuarios en tema General con el comando /send all onboarding

Envío por Etiqueta¶

Si necesita enviar la plantilla guardada special_offer solo a clientes con etiqueta vip:

/send mark vip template special_offer

Límites de Envío¶

Versión del Sistema	Límite de Mensajes por Mes
Gratuito	500
Pago	desde 4000 en plan mínimo (todos los planes)

Expandir límites

Para aumentar los límites estándar, contacte al servicio de soporte.

Restricción de Acceso¶

Por defecto, las funciones para configuración y lanzamiento de envíos solo están disponibles para administradores de conexiones. El acceso se puede extender a través del parámetro EXTENSIONS_ALLOWED.

Comando /send en temas

Los operadores pueden usar el comando /send en temas incluso sin acceso administrativo.

Llamar al Comando¶

¡El comando /send funciona diferente dependiendo de dónde se llama!

En Tema General (con `reply` al mensaje)¶

Se usa para enviar mensaje específico o crear plantilla.

Enviar mensaje

Enviar a usted mismo para prueba:

/send test [now,delay,datetime] [instance_id]

Enviar a todos los usuarios con quienes hubo diálogo:

/send all [now,delay,datetime] [instance_id]

Enviar a usuarios de archivo adjunto (lista de user_id puede separarse por comas, espacios o nueva línea):

/send file [now,delay,datetime] [instance_id]

Enviar a usuarios de lista separada por comas:

/send list [now,delay,datetime] [instance_id] USER_ID1,USER_ID2

Enviar a todos los usuarios con etiqueta especificada:

/send mark MARK_NAME [now,delay,datetime] [instance_id]

Crear plantilla

Agregar mensaje a plantilla nueva o existente (nombre de plantilla debe comenzar con letra latina, puede contener números, guión o guión bajo):

/send TEMPLATE_NAME [now,delay,datetime]

Crear cadena de mensajes

Enviar primer mensaje y responder a él: /send welcome
Enviar segundo mensaje y responder a él: /send welcome 5m
Enviar tercer mensaje y responder a él: /send welcome 1h

Resultado: la plantilla welcome contendrá tres mensajes. El primero se enviará inmediatamente, el segundo — 5 minutos después del primero, el tercero — 1 hora después del segundo.

En Tema General (sin `reply`)¶

Se usa para lanzar envíos masivos, gestionar plantillas y envíos.

Enviar plantilla

Enviar plantilla a usted mismo para prueba:

/send test TEMPLATE_NAME [now,delay,datetime] [instance_id]

Enviar plantilla a todos los usuarios:

/send all TEMPLATE_NAME [now,delay,datetime] [instance_id]

Enviar plantilla a usuarios de archivo:

/send file TEMPLATE_NAME [now,delay,datetime] [instance_id]

Enviar plantilla a usuarios de lista:

/send list TEMPLATE_NAME [now,delay,datetime] [instance_id] USER_IDS

Enviar plantilla a todos los usuarios con etiqueta:

/send mark MARK_NAME template TEMPLATE_NAME [now,delay,datetime] [instance_id]

Ver información

Mostrar todas las plantillas creadas:

/send templates

Mostrar envíos recientes:

/send sendings [instance_id]

Mostrar propiedades de plantilla:

/send TEMPLATE_NAME

Mostrar estado y informe de envío:

/send sidSENDING_ID

Editar y eliminar

Renombrar plantilla:

/send TEMPLATE_NAME name NEW_NAME

Cambiar tiempo de envío de mensaje en plantilla:

/send TEMPLATE_NAME for MESSAGE_ID [now,delay,datetime]

Eliminar mensaje de plantilla:

/send TEMPLATE_NAME del MESSAGE_ID

Eliminar plantilla completamente:

/send TEMPLATE_NAME del

Cancelar envío (solo si está en estado awaits):

/send sidSENDING_ID del

En Tema de Diálogo (sin `reply`)¶

Se usa para enviar plantilla a usuario o chat específico.

Enviar plantilla

Enviar plantilla al usuario de este tema:

/send TEMPLATE_NAME [now,delay,datetime]

Mostrar plantillas disponibles:

/send templates

Mostrar envíos para este tema:

/send sendings

Mostrar estado de envío (sin informe):

/send sidSENDING_ID

Configuración de Tiempo¶

Para cada mensaje puede especificar tiempo de envío en parámetro [now,delay,datetime]:

Formato	Descripción	Ejemplo
`now`	Enviar inmediatamente (predeterminado)	`now`
Retraso	Envío retrasado	`5m 30s`, `5m`, `2h`, `1d`
Fecha y hora	Hora fija en UTC	`2024-12-27 14:25:55`

Cadenas de mensajes

En plantillas con múltiples mensajes, el retraso se cuenta desde el momento de envío del mensaje anterior en la cadena.

Parámetro `instance_id`¶

Con múltiples conexiones en un grupo backend, puede especificar instance_id para ejecutar comando para conexión específica.

Comportamiento predeterminado

Sin especificar instance_id, el comando se ejecuta independientemente para cada conexión en el grupo backend.

Ayuda Rápida¶

Enviar comando /send o /send help en cualquier contexto para obtener ayuda breve en inglés.

Envíos Masivos /send¶