Base de conocimiento de GetMyBot

Estudio de contenido

Preparar un mensaje una vez y usarlo en difusiones o en el sitio. Borradores, publicación, sustituciones y comprobación antes del envío.

En esta página

En Contenido puedes preparar un mensaje y reutilizarlo. Por ejemplo, una versión publicada del programa de un curso puede enviarse por Telegram y VK. El texto, las imágenes y los botones forman un documento de contenido. Para un email, un popup o una notificación push se crean documentos de los tipos correspondientes.

Prepara un borrador, comprueba cómo se verá en el canal que necesitas y publica una versión. Un documento de tipo Mensaje puede usarse en varios mensajeros y en el chat web, pero se valida y se muestra por separado para cada canal.

Editar contenido requiere el mismo permiso sobre el bot que editar reacciones. Sin él, la sección se abre en modo de solo lectura: puedes ver los documentos, pero no crearlos, cambiarlos, publicarlos, archivarlos ni enviar pruebas.

Documentos, borradores y versiones

Cada documento tiene un tipo que determina dónde se puede usar: Mensaje, Correo electrónico, Ventana emergente, Mensaje dentro de la aplicación, Notificación push, Respuesta rápida o Bot de prospectos. Un documento Push sirve para push del navegador y push móvil en una difusión o campaña.

Cada documento tiene exactamente un borrador editable y puede tener muchas versiones publicadas:

  • Editar solo cambia el borrador actual.
  • Publicar guarda el borrador como una versión inmutable y abre enseguida otro borrador con el mismo contenido.
  • Una versión publicada nunca se sobrescribe. Una difusión programada o un popup activo siguen usando la versión concreta a la que quedaron vinculados.

Por ejemplo, si una difusión está programada con la versión 2, editar el borrador y publicar la versión 3 no cambia su mensaje. Para usar el texto nuevo, selecciona la versión nueva en la difusión o el popup.

El guardado protege frente a ediciones simultáneas: la interfaz envía la versión y revisión que había cargado y el servidor responde 409 si otra persona cambió el documento entretanto. Vuelve a cargarlo antes de intentar guardar otra vez.

Archivar retira el documento de la lista. No puedes archivarlo mientras lo use un popup activo, una difusión de email programada, en curso o en pausa, o un envío push aceptado o en curso. Primero elimina esas referencias.

Bloques y límites

Un documento se construye con bloques:

  • Texto, Encabezado, Lista y Separador: texto con formato opcional.
  • Imagen, Archivo y Vídeo: archivo de la biblioteca multimedia o URL, más una descripción.
  • Botón: texto con un enlace o datos para una acción al pulsarlo (callback).
  • Columnas: grupo de hasta cuatro bloques secundarios. Agrupa contenido en el editor, pero al enviarlo los bloques se entregan uno tras otro. Si el canal no admite columnas, aparece el aviso columns_flattened.
  • Contenido condicional: grupo que solo se muestra cuando se cumple una condición.

El servidor comprueba los límites al guardar y vuelve a comprobarlos al publicar:

  • Nombre del documento: entre 1 y 120 caracteres.
  • Al menos un bloque y como máximo 200 en total.
  • Profundidad de anidamiento máxima de 8 niveles.
  • Hasta 10 botones en un mismo nivel.
  • Un bloque Columnas admite hasta 4 bloques secundarios.
  • Cada bloque necesita un ID, único dentro del documento.

Tanto al guardar como al publicar, el servidor valida el documento completo y comprueba que todos los archivos multimedia usados pertenezcan a este bot. El servidor rechazará un dato incorrecto aunque el navegador lo haya aceptado.

Sustituciones

Las sustituciones usan llaves dobles y se rellenan al enviar:

¡Hola, {{profile.first_name}}! Tu pedido {{event.order_id}} ya está en camino.

Solo se admiten estas cuatro formas:

  • {{profile.<campo>}}: campo del perfil del destinatario.
  • {{event.<campo>}}: campo del evento actual.
  • {{system.unsubscribe_url}}: enlace para que ese destinatario se dé de baja.
  • {{system.current_date}}: fecha actual con formato AAAA-MM-DD.

Cualquier otra forma se rechaza. El contenido no puede ejecutar JavaScript, SQL, un motor de plantillas ni peticiones HTTP.

No todos los datos de un cliente están automáticamente disponibles en un documento. Solo pueden usarse los campos profile y event que entrega el lugar desde el que se enviará. Este conjunto se llama lista de campos permitidos. Si indicas otro campo, aparece un error de «sustitución prohibida», aunque ese dato exista en la base.

Si un campo permitido no tiene valor para ese destinatario, también se produce un error, salvo que el documento tenga un valor alternativo. Estos valores se guardan en fallbacks, usando la ruta completa como clave:

{ "fallbacks": { "profile.first_name": "amigo" } }

Solo se acepta un valor alternativo para una ruta que esté en la lista permitida y su longitud máxima es de 16 000 caracteres.

El sistema protege automáticamente el valor según dónde se inserte: en texto con formato HTML, escapa caracteres HTML; dentro de una URL, codifica los caracteres especiales. Los valores system.* no se codifican otra vez dentro de URL porque ya son enlaces completos.

Bloques condicionales

Puedes añadir una condición a cualquier bloque. Contenido condicional agrupa varios bloques bajo una misma condición.

Las condiciones del contenido son más limitadas que las de los segmentos porque, al mostrarlo, solo se conocen el perfil y el evento actual:

  • Sujeto: solo profile o event.
  • Operadores: eq, ne, gt, lt, ge, le, gte, lte, exists, not_exists, contains, not_contains, in, not_in, between, before, after, has_any, not_has_any.
  • No se admiten ventanas temporales como «en los últimos N días».

Una condición que necesita datos no disponibles al mostrar el contenido produce condition_unsupported; una condición mal formada produce condition_invalid. Las versiones publicadas anteriormente pasan por la misma comprobación antes del envío. Así, una condición no admitida aparece como error de validación y no como un fallo de entrega.

Comprobación por canal y vista previa

Comprobar representa la versión elegida según las capacidades reales del canal y devuelve dos listas.

Los errores impiden publicar o enviar:

  • text_too_long: el texto supera el límite del canal.
  • media_missing: una imagen, archivo o vídeo no tiene archivo ni URL.
  • media_unsupported: el canal no admite ese tipo de contenido multimedia.
  • button_unsupported: el canal no admite botones inline y el botón no tiene un enlace que pueda mostrarse en su lugar.
  • invalid_document: se incumple una regla estructural de las indicadas arriba.
  • condition_invalid, condition_unsupported: la condición es incorrecta o no está admitida.

Los avisos no impiden enviar, pero muestran cómo se simplificará el contenido:

  • columns_flattened: el canal no tiene columnas; los bloques se enviarán seguidos.
  • format_flattened: el canal no admite ese formato y recibirá texto simple.
  • button_as_link: el botón se mostrará como un enlace.
  • missing_image_alt: falta texto alternativo para una imagen.
  • vague_link_text: el texto del botón está vacío o dice «click here», «here», «link» o «more».

La vista previa muestra el resultado en el canal elegido, Sitio, Email, Telegram, VK o WhatsApp, en ordenador y móvil. Si seleccionas un destinatario real, el contenido se representa con sus datos y podrás detectar errores de sustitución antes de enviar.

Un mismo documento puede estar listo para un canal y bloqueado para otro. Por ejemplo, Email conserva columnas y formato HTML, admite imágenes y archivos, pero no vídeo; los botones se convierten en enlaces (button_as_link).

Envío de prueba

Un envío de prueba recorre exactamente la misma validación, representación y cola que un envío real, pero solo para un destinatario. No puedes escribir cualquier dirección o ID de chat: elige un contacto al que el bot ya pueda enviar por el canal seleccionado.

La solicitud se rechaza si:

  • El contacto no está verificado (422).
  • El contacto está excluido de los envíos, por ejemplo se dio de baja o su dirección no recibe mensajes (409).
  • El documento cambió desde que se cargó (409).
  • El canal no está disponible en esta instalación (422).
  • El contenido no puede representarse para el canal elegido (422).
  • Se agotó la cuota del canal (409).
  • Hubo demasiadas pruebas en poco tiempo (429). El límite es por cuenta: tres seguidas y después una cada 15 segundos.

Una llamada correcta devuelve 202 y pone el mensaje en cola; luego lo entrega el mecanismo normal de envío.

Plantillas

Plantillas ofrece documentos de ejemplo. Al elegir uno, copia sus bloques a un borrador nuevo. La plantilla es un punto de partida, no una vinculación permanente: cambiarla después no altera documentos ya creados.

La galería muestra las plantillas incluidas con la instalación y las propias de este bot. Si no hay ninguna, aparece vacía. Todavía no hay un botón «Guardar como plantilla»: las plantillas del bot se crean y eliminan por API (POST /api/bots/{botID}/content-templates).

Tema, tamaños y espacios

El tema del documento establece fuentes y colores generales. Puedes cambiar la apariencia de un bloque concreto en el inspector. El espacio interior separa el contenido de su borde; el exterior, de los bloques vecinos. Los espacios se miden en píxeles y la anchura del bloque, en porcentaje del área de contenido.

La altura de línea se expresa como multiplicador: 1.5 equivale a un interlineado de una vez y media. Revisa los saltos de línea en las vistas previas grande y móvil. Los ajustes disponibles dependen del canal; la comprobación te avisará si simplifica el formato o envía las columnas una tras otra.

HTML original del email

En un email puedes alternar entre el editor visual y el código HTML. Después de cambiar el HTML, espera la comprobación. Si hay un error, corrígelo antes de volver al modo visual o guardar.

Al importar HTML, los elementos no admitidos pueden cambiar. Revisa el resultado y prueba el email en los clientes de correo de tus destinatarios: cada uno presenta el HTML de forma distinta.

Editar un elemento del email

Selecciona un elemento en el editor visual y cambia sus propiedades disponibles en el inspector: texto, enlace, imagen o contenedor. Los valores se aplican cuando el campo pierde el foco. Un enlace tiene una URL de destino y un texto visible; el texto alternativo de una imagen la describe para quien no puede verla.

Si algo falla

  1. «Sustitución prohibida»: la ruta no está en la lista de campos permitidos para ese contexto o está mal escrita. Inserta las sustituciones con el selector.
  2. «Falta una sustitución»: el destinatario no tiene valor para un campo permitido. Añade un valor alternativo a los ajustes del documento.
  3. La publicación devuelve 409: otra persona cambió el documento. Vuelve a cargarlo y publica otra vez.
  4. No se puede archivar: el documento sigue vinculado a un popup activo, una difusión vigente o un envío push en curso.
  5. No está disponible el envío de prueba: todavía no hay un contacto verificado, no excluido, en un canal conectado.

Qué sigue