Base de conocimientos

hotline.tg

Bot para las masas Telegram mailings y segmentación de audiencia

Capacidades del equipo /send, /mark и /export para Telegram CRM Hotline.
Después de conectar su bot o cuenta de usuario habitual a Hotline CRM (se conecta en paralelo a bots o cuentas existentes, no afecta su trabajo, hecho gratis en unos minutos), es posible utilizar tres potentes comandos interconectados desde nuestro bot de extensión en el lado de su grupo de backend:

/send – para envíos masivos de mensajes individuales o plantillas con cadenas de mensajes a usuarios de Telegram

/mark – para asignar etiquetas (estados adicionales) a temas de usuario y determinar el comportamiento de las etiquetas

/export – exportar como archivo una lista de usuarios con los que hubo correspondencia a través del sistema Hotline y/o tener la etiqueta especificada
Conexión del bot de extensión
Para utilizar los comandos descritos en este artículo, debe agregar un bot de extensión @hotlinetg_extensiones_bot con derechos de administrador para su grupo backend.

Versión básica Hotline (el núcleo del sistema) es responsable de la transmisión confiable del flujo de mensajes con los usuarios y contiene solo funcionalidad principal.
Límites del sistema de correo
La versión gratuita del sistema le permite enviar a través del sistema de correo un comando /send hasta 200 mensajes por mes. La versión paga del sistema le permite enviar hasta 1000*N mensajes por mes, donde N es igual al número de operadores del sistema. en una suscripción paga.

Si necesita ampliar los límites estándar para el envío de mensajes, comuníquese con Apoyar.

Restricciones para equipos /mark и /export no.
Ayuda rapida
Para obtener ayuda rápida en inglés en su grupo backend, puede enviar un comando en cualquier momento /send, /mark o /export sin parámetros en el contexto apropiado (en General tema, tema personalizado o en una respuesta a un mensaje).
Limitación de acceso
Funciones administrativas del equipo /send, /mark и /export sólo disponible desde General Tema del grupo backend, el acceso a ellos se puede limitar mediante un parámetro especial. @EXTENSIONS_ALLOWED@ en el robot de instalación @hotlinetg_bot.

Opciones de uso de comandos /send

Equipo /send le permite enviar mensajes individuales o incluso hilos de mensajes que contengan todos los tipos de mensajes principales Telegram: texto con cualquier formato, stickers, mensajes de voz, videos, imágenes, archivos.

Como destinatarios del correo podrán indicarse los siguientes:
  • operador ejecutando el comando /send, para probar el mensaje (opcional test)
  • todos los usuarios con los que existe un diálogo (tema) a través del sistema Hotline (opción all)
  • listado de usuarios en el archivo adjunto (opción file)
  • lista de usuarios separados por comas en el propio comando (opción list)
  • todos los usuarios a los que se les asigna la etiqueta correspondiente mediante el comando /mark (opción mark)

Puedes enviar tanto mensajes individuales (sin guardar el mailing como plantilla) como cadenas de mensajes (guardando un único mensaje o una secuencia de mensajes como plantilla con las opciones necesarias).

Para cada mensaje enviado en el parámetro opcional [now,delay,datetime] Puedes especificar la hora de envío:
  • now (se enviará en el momento en que se llame el comando, se usa de forma predeterminada)
  • con retraso en el formato 100s 10m 5h 2d (de 1 a 4 parámetros con la cantidad requerida de segundos, minutos, horas o días) desde el momento en que se envió el comando o el momento en que se envió el mensaje anterior de la cadena)
  • fecha y hora fijadas de envío por UTC en el formato 2024-12-27 14:25:55
Equipo /send tiene 3 contextos principales de uso:

Los parámetros opcionales para los comandos se indican entre corchetes.

/send в General tema como reply mensajear

Enviar un mensaje a la lista deseada de destinatarios

↳ /send test [now,delay,datetime] [instance_id]
Enviar especificado en reply mensaje a ti mismo para probar

↳ /send all [now,delay,datetime] [instance_id]
Enviar especificado en reply mensaje a todos los usuarios con los que alguna vez ha habido un diálogo a través de Hotline

↳ /send file [now,delay,datetime] [instance_id]
Enviar especificado en reply mensaje a todos los usuarios, user_id que se indican en el archivo adjunto. Lista user_id en un archivo se puede separar por comas, espacios o nuevas líneas. Se ignoran los valores no numéricos del archivo.

↳ /send list [now,delay,datetime] [instance_id] USERS_LIST
Enviar especificado en reply mensaje a todos los usuarios, user_id que se especifican en la lista (último parámetro de comando). Valores en la lista user_id separados por comas.

↳ /send mark MARK_NAME [now,delay,datetime] [instance_id]
Enviar especificado en reply mensaje a todos los usuarios con una etiqueta determinada MARK_NAME comando de galleta /mark.
Parámetro opcional instance_id se puede especificar si varias instancias están conectadas a un grupo de backend y es necesario indicar explícitamente para cuál de ellas el comando de General tema. De forma predeterminada, todos los comandos se ejecutan de forma independiente para cada instancia. Hotline.
Cree una plantilla para enviar o agregar un mensaje a una plantilla existente

↳ /send TEMPLATE_NAME [now,delay,datetime]
Agrega lo especificado en reply mensaje a una plantilla nueva o existente llamada TEMPLATE_NAME. El nombre de la plantilla debe comenzar con una letra latina, puede contener números, un guión o un guión bajo y no distingue entre mayúsculas y minúsculas. Una plantilla puede contener un mensaje o una cadena de mensajes. Puede configurar la hora a la que se envía el mensaje (desde el momento en que se llama al comando para el primer mensaje o desde el momento en que se envía el mensaje anterior de la cadena).

/send в General tema (sin reply)

Enviar mensajes desde una plantilla específica a la lista deseada de destinatarios

/send test TEMPLATE_NAME [now,delay,datetime] [instance_id]
Enviar plantilla TEMPLATE_NAME a mi mismo para probar

/send all TEMPLATE_NAME [now,delay,datetime] [instance_id]
Enviar plantilla TEMPLATE_NAME a todos los usuarios con los que alguna vez ha habido un diálogo a través de Hotline

/send file TEMPLATE_NAME [now,delay,datetime] [instance_id]
Enviar plantilla TEMPLATE_NAME a todos los usuarios, user_id que se indican en el archivo adjunto. Lista user_id en un archivo se puede separar por comas, espacios o nuevas líneas. Se ignoran los valores no numéricos del archivo.

/send list TEMPLATE_NAME [now,delay,datetime] [instance_id] USERS_LIST
Enviar plantilla TEMPLATE_NAME a todos los usuarios, user_id que se especifican en la lista (último parámetro de comando). Valores en la lista user_id separados por comas.

/send mark MARK_NAME template TEMPLATE_NAME [now,delay,datetime] [instance_id]
Enviar plantilla TEMPLATE_NAME todos los usuarios con una etiqueta determinada MARK_NAME comando de galleta /mark.
Ver la lista o propiedades de plantillas y correos creados

/send templates
Mostrar todas las plantillas de newsletter creadas.

/send sendings [instance_id]
Muestra los últimos correos creados (si hay varias instancias conectadas al grupo backend, puedes especificar cuál).

/send TEMPLATE_NAME
Mostrar propiedades de la plantilla de correo especificada.

/send sidSENDING_ID
Muestre el estado y las propiedades del correo especificado, así como obtenga un informe sobre su ejecución hasta la fecha.
Editar y eliminar plantillas y correos

/send TEMPLATE_NAME name NEW_NAME
Establecer un nuevo nombre para la plantilla

/send TEMPLATE_NAME for MESSAGE_ID [now,delay,datetime]
Establecer una nueva hora de envío en la plantilla para un mensaje con el ID especificado

/send TEMPLATE_NAME del MESSAGE_ID
Eliminar un mensaje con una ID especificada de la plantilla

/send TEMPLATE_NAME del
Eliminar la plantilla especificada

/send sidSENDING_ID del
Eliminar y cancelar un envío con el ID especificado (disponible solo si el envío aún no se ha realizado y se encuentra en el estado awaits)

/send en un tema personalizado (sin reply)

Envío de la plantilla especificada al usuario del tema

/send TEMPLATE_NAME [now,delay,datetime]
Además, puede especificar la hora de envío.
Mostrar información sobre plantillas y correos

/send templates
Mostrar plantillas creadas en el grupo backend.

/send sendings
Mostrar envíos por comando /send para el tema actual.

/send sidSENDING_ID
Mostrar el estado y las propiedades del envío especificado (sin recibir un informe).
IMPORTANTE: Después de agregar extensiones bot @hotlinetg_extensiones_bot todas las funciones de comando llamadas en temas de usuario a su grupo de backend /send и /mark estar disponible para todos los usuarios del grupo backend (empleados, gerentes). Al mismo tiempo, las funciones administrativas de los equipos. /send, /mark o /exportLlamada entrante General el tema se puede limitar a través del parámetro @EXTENSIONS_ALLOWED@ en la conexión correspondiente en el bot de instalación @hotlinetg_bot.

Opciones de uso de comandos /mark

Equipo /mark le permite asignar un conjunto arbitrario de etiquetas a temas con diálogos en el lado del grupo backend (pueden ser temas de diálogos con usuarios o bots, o temas de comunicación en grupos).

Las etiquetas se pueden utilizar para asignar propiedades adicionales arbitrarias a temas y/u operaciones auxiliares convenientes.
Capacidades de etiqueta:

  • asignar temas adicionales a temas propiedades para la segmentación y/o uso posterior en mailings por parte del equipo /send o al exportar con el comando /export
  • establecer estados del embudo de ventas, al establecer el siguiente estado se eliminan todos los estados anteriores del conjunto dado (parámetro after)
  • envío automático de una plantilla con una cadena de mensajes después de asignar la etiqueta apropiada al tema (parámetro sends)
  • mostrar una cadena corta o un emoji en el título del tema, que contiene las iniciales del gestor responsable de la transacción, la bandera del país/idioma del usuario u otra propiedad (parámetro ticker)
Equipo /mark tiene 2 contextos principales de uso:

/mark в General tema


/mark
Muestra una lista de etiquetas creadas para este grupo de backend.

/mark new MARK_NAME
Crea una nueva etiqueta con el nombre de pila. El nombre de la etiqueta debe comenzar con una letra latina y puede contener letras latinas; los números, un guión o un guión bajo no distinguen entre mayúsculas y minúsculas.

/mark MARK_NAME
Muestra las propiedades de la etiqueta y una lista de temas con esta etiqueta.

/mark MARK_NAME after MARK1, MARK0
Establecer parámetro AFTER para la etiqueta. El valor especifica una lista de nombres de etiquetas que se eliminarán del tema cuando se asigne esta etiqueta. La lista puede tener cualquier longitud, los valores están separados por comas. Para borrar un parámetro, envíe el valor CLEAR.

/mark MARK_NAME sends TEMPLATE_NAME
Establecer parámetro SENDS para la etiqueta. El valor especifica el nombre de la plantilla de comando. /send (con un solo mensaje o una cadena de mensajes) que se activará cuando se asigne esta etiqueta. Para borrar un parámetro, envíe el valor CLEAR.

/mark MARK_NAME ticker STRING|EMOJI
Establecer parámetro TICKER para la etiqueta. El valor puede ser una cadena corta (letras latinas, números, guión, guión bajo) o un emoji, que se agregará al nombre del tema al asignar esta etiqueta. Para borrar un parámetro, envíe el valor CLEAR.

/mark MARK_NAME name NEW_MARK_NAME
Establezca un nuevo nombre para la etiqueta.

/mark en el tema con dialogo


/mark
Muestra una lista de etiquetas específicas para este tema.

/mark MARK_NAME
Agregue la etiqueta especificada para este tema.

/mark del MARK_NAME
Elimine la etiqueta especificada para este tema.

uso de comandos /export

Equipo /export le permite obtener en forma de archivo una lista de usuarios con quienes hubo correspondencia a través del sistema Hotline y tener la etiqueta especificada.
El comando sólo se puede utilizar en General tema grupal.

/export all
Exporta todos los temas como un archivo CSV que contiene todas las propiedades principales del tema (user_id, fecha del último mensaje, estado del diálogo, nombre del tema, tipo de tema, enlace al tema).

/export MARK_NAME
Exporta todos los temas con una etiqueta determinada como un archivo CSV en el formato descrito anteriormente.
Si tiene dificultades para utilizar las funciones del bot de extensión, comuníquese con servicio de soporte.