Paso Send Message

Paso Send Message: envía tu primer mensaje

Después de crear tu primer flow, ábrelo, haz clic en "Edit Flow", pon tu bot al lado y empecemos.

Tomemos Facebook como ejemplo. Otros flows comparten procesos similares; la diferencia principal es el tipo de mensaje.

TODO_IMAGE[image-20260613-040135.png]: revisar imagen desde Confluence.

Unos pasos simples para enviar tu primer mensaje:

• haz clic en el punto verde de inicio

• en el panel de edición, selecciona "Select Next Step"

• elige el step "Send Message"

• haz clic en el step "Send Message"

• haz clic en mensaje de tipo texto

• ingresa tu mensaje

• haz clic en "Publish"

TODO_IMAGE[image-20260613-040157.png]: revisar imagen desde Confluence.

Eso es todo. Ahora probemos.

TODO_IMAGE[image-20260613-040220.png]: revisar imagen desde Confluence.

Haz clic en "Preview" desde la barra de navegación para abrir la ventana Preview content, luego elige el canal que quieres probar: Web, Facebook, Instagram, WhatsApp, Telegram y más si estás probando en omnichannel. Según el canal, puedes previsualizarlo en un popup, abrirlo en tu navegador web, copiar el Ref URL o escanear el código QR para abrir el flow en tu teléfono.

Función Preview: ten en cuenta que la función "Preview" no está soportada en todos los canales. Los canales que soportan "Preview" son Facebook, Telegram, WhatsApp, Line y Viber. Para canales sin Preview, busca "talk to bot" en la documentación para ver la guía.

TODO_IMAGE[image-20220703-050515.png]: revisar imagen desde Confluence.

Felicitaciones. Tu bot ya está funcionando.

Ahora veamos más detalles sobre el step Send Message. Estos son los tipos de mensaje comunes para todos o algunos de los canales.

Enviar texto / variable

TODO_IMAGE[image-20220703-052004.png]: revisar imagen desde Confluence.

OneChat está integrado con Grammarly para ayudarte a perfeccionar tu redacción.

TODO_IMAGE[image-20220703-052019.png]: revisar imagen desde Confluence.

Insertar valor de Custom Field y emoji

Donde veas "", puedes insertar emojis o valores de variables en el texto.

TODO_IMAGE[1.gif]: revisar imagen desde Confluence.

O simplemente escribe "{{" para abrir la lista de fields:

TODO_IMAGE[2.gif]: revisar imagen desde Confluence.

Enviar imagen / audio / video / archivo

Hay 4 formas en total:

TODO_IMAGE[image-20220703-052244.png]: revisar imagen desde Confluence.

• subir desde tu computador (con límite de tamaño)

| Tipo de media | Tamaño máximo de subida |

| --- | --- |

| video | 10MB |

| audio | 5MB |

| file | 5MB |

| otros, por ejemplo imagen | 2MB |

• Desde un enlace URL (recomendado). Puedes buscar imágenes online y copiar sus enlaces directos. Pero ese enlace directo puede cambiar. Como alternativa, puedes subir fotos a tu servidor o a servicios de almacenamiento de fotos de terceros, como Imgur (http://imgur.com), y obtener desde allí los enlaces directos. Un enlace directo significa que el enlace apunta a una foto específica, no a un sitio web, y termina en .jpg, .png, etc. Toma como ejemplo el enlace de la imagen anterior.

• Buscar desde la galería de GIFs. OneChat ofrece una galería de GIFs donde puedes buscar lo que necesitas.

• Desde Library. Library es el lugar donde puedes ver todas las fotos, GIFs, audios y videos que has subido antes. Así no necesitas volver a subir el mismo media; solo búscalo en tu library.

Enviar Card

TODO_IMAGE[image-20220703-052930.png]: revisar imagen desde Confluence.

Card se usa para mostrar una serie de información de forma agradable, como información de productos. Hay 4 elementos en una card: imagen, título, subtítulo y botón.

Ten en cuenta que para mostrar una card debes tener un título y al menos otro elemento: imagen, subtítulo o botón.

Si quieres enviar una card en el canal de WhatsApp, tendrás que crear una "Carousel Template" y luego usar "Carousel template" en su lugar.

Enviar "For Each"

Este tipo de mensaje también muestra cards, pero de una forma más automática. Con "For Each", no necesitas escribir cada card manualmente. Se muestran automáticamente todos los items de una variable JSON. Revisa Action Step - JSON Operation si no sabes qué es una variable JSON.

TODO_IMAGE[image-20220703-053034.png]: revisar imagen desde Confluence.

• elige primero una variable JSON

• haz clic en "" o escribe "{{" en el cuadro de texto

• elige "ITEM" para obtener un item de muestra de la variable JSON

Valor en la variable JSON:

TODO_IMAGE[image-20220703-053056.png]: revisar imagen desde Confluence.

Valor en "ITEM":

TODO_IMAGE[image-20220703-053113.png]: revisar imagen desde Confluence.

"Sample data" sirve para completar rápidamente el campo "JSON Path". Por ejemplo, como se muestra en la imagen, al hacer clic en la fila "price", aparece "$.price" en el campo "JSON Path". Esto significa que estamos mostrando el precio de cada item aquí. Si no aparece sample data, puedes completar la ruta manualmente escribiendo "$.", que se refiere a cada item en la variable JSON, seguido de la key de un valor.

Formato de valor

Además, para números como porcentajes y precios, y para valores de fecha y hora, OneChat lista diferentes formatos. Por ejemplo, en la imagen anterior, el valor del precio es "5" y después de elegir el formato "F03", el bot lo mostrará como "$5". El valor en la variable sigue siendo el número "5", por lo que podrás usarlo en cálculos matemáticos o comparaciones condicionales sin errores.

Keys ocultas

Muy bien. Ahora ya ves cómo usar "For Each". Además de las keys de la variable JSON, hay 3 keys ocultas que podrías necesitar:

TODO_IMAGE[image-20220703-053147.png]: revisar imagen desde Confluence.

| Nombre de key | Descripción |

| --- | --- |

| INDEX | índice del item empezando desde 1 |

| KEY | nombre de la key del item |

| VALUE | valor del item = el item en sí |

#### Ejemplo de INDEX

Cuando tienes un JSON con una lista de JSONs dentro, usa INDEX para revisar el número de secuencia de un item. Agreguemos un número de índice antes del nombre del item:

TODO_IMAGE[image-20220703-053229.png]: revisar imagen desde Confluence.

Resultado de prueba:

TODO_IMAGE[image-20220703-053250.png]: revisar imagen desde Confluence.

#### Ejemplo de KEY/VALUE

Cuando tienes un JSON como se muestra en la siguiente imagen, en vez de un JSON que contiene una lista de JSONs:

TODO_IMAGE[image-20220703-053351.png]: revisar imagen desde Confluence.

Esto es lo que obtendrás usando las tres keys:

TODO_IMAGE[image-20220703-053403.png]: revisar imagen desde Confluence.

TODO_IMAGE[image-20220703-053421.png]: revisar imagen desde Confluence.

Resultado de prueba:

TODO_IMAGE[image-20220703-053444.png]: revisar imagen desde Confluence.

Enviar SELECT después de "For Each"

Cuando agregas un botón a tu "For Each", el botón se mostrará en cada card. Normalmente podrías poner un botón "Buy" o "Select" cuando estás listando productos u opciones.

¿Cómo sabe el bot qué card seleccionó el usuario?

TODO_IMAGE[image-20220703-053501.png]: revisar imagen desde Confluence.

Cuando selecciones el siguiente step para el botón, elige "Select":

TODO_IMAGE[image-20220703-053516.png]: revisar imagen desde Confluence.

Luego selecciona el siguiente step como lo haces normalmente, por ejemplo un Send Message Step para mostrar el item seleccionado o un Action Step para trabajar con los datos. Después podrás acceder al item seleccionado en "SELECT":

TODO_IMAGE[image-20220703-053538.png]: revisar imagen desde Confluence.

Por ejemplo, agreguemos un Send Message step y busquemos el system field "SELECT":

TODO_IMAGE[image-20220703-053554.png]: revisar imagen desde Confluence.

• haz clic en la fila "item" para obtener la ruta "$.item" o escribe la ruta directamente

• en JSON path, agrega el nombre de la key si es necesario. En este caso, mostremos el nombre del item seleccionado, así que agrega ".name" después de la ruta.

TODO_IMAGE[image-20220703-053612.png]: revisar imagen desde Confluence.

TODO_IMAGE[image-20220703-053639.png]: revisar imagen desde Confluence.

Verás esto cuando lo pruebes:

TODO_IMAGE[image-20220703-053720.png]: revisar imagen desde Confluence.

Enviar Dynamic Content

Dynamic Content te ayuda a enviar una solicitud API a tu servidor o a un servidor de terceros para obtener una respuesta que se mostrará. El servidor puede responder de forma diferente cada vez. De esta manera, tu bot puede mostrar contenido dinámico a tus usuarios.

Esta función es práctica cuando la lógica de tu bot es compleja y depende mucho de otros servidores.

Por ejemplo, si tienes tu propio algoritmo de IA para analizar preguntas de usuarios y calcular la respuesta correspondiente en tu servidor, puedes enviar la pregunta en la solicitud API. El servidor puede generar una respuesta basada en la pregunta y finalmente enviar la respuesta de vuelta a OneChat para mostrarla a tus usuarios.

Un mensaje de respuesta puede contener varios mensajes, botones y quick replies con acciones. Incluso puedes aplicar acciones simples, como agregar un tag, directamente en el JSON de respuesta.

• Revisa Action Step - External Request para saber cómo enviar una solicitud API.

• Y Response Format para ver la guía de formato de mensajes.

Enviar ubicación

TODO_IMAGE[image-20220703-053753.png]: revisar imagen desde Confluence.

Para enviar una ubicación, búscala en un mapa y luego haz clic derecho para copiar sus valores de latitud y longitud:

TODO_IMAGE[image-20220703-053805.png]: revisar imagen desde Confluence.

Ingresa el nombre de la ubicación, pega los datos y agrega un label si es necesario. Un label da información adicional como piso o número de habitación.

TODO_IMAGE[image-20220703-053835.png]: revisar imagen desde Confluence.

Enviar producto de ecommerce

Revisa Ecommerce para saber cómo configurar y usar el sistema de ecommerce integrado.

Enviar Send Message Debug Text

La función Send Message Debug está diseñada para facilitar la depuración a los constructores de chatbots, ofreciendo una forma sencilla de enviar mensajes de debug específicamente a testers.

Acceder a Debug Text:

Navega a Send Message y selecciona Debug Text.

TODO_IMAGE[u4cnt6llXPu9kKIbm-FQT40xY8h9pXBHI70tX2S5Vfxi4SWAVLw7P4hK5ay8sOOfYzrEw7k4LT_7j9QjCrcejQjxV-Yh2m3p]: revisar imagen desde Confluence.

Agregar testers:

• Navega a Tools -> Testers -> New Tester.

• Identifica los usuarios que servirán como testers para tu chatbot.

• Agrega esos usuarios a la lista de testers.

TODO_IMAGE[ZYtEVF8tdnBj6Yit17blguK4qiF9lKDdKP00hgSTyP9z8niMbaZnCoLMl-YlfbydqIRcytFs7A0bK0nuo4L-D7IfimXtbWyt]: revisar imagen desde Confluence.

Enviar mensajes de debug:

• Una vez agregados los testers, activa el flow preview donde incorporaste Send Message Debug Text.

• Durante la vista previa, el debug text será visible para los testers agregados.

Canales de Facebook

Send Message

Facebook permite que el bot envíe textos con máximo 3 botones y 10 quick replies.

Enviar texto con botón y quick reply

TODO_IMAGE[image-20220703-053921.png]: revisar imagen desde Confluence.

La diferencia entre button y quick reply en Facebook Messenger:

| Tipo | Uso |

| --- | --- |

| button | una vez enviado, permanece en la conversación para poder presionarse |

| quick reply | similar a un botón, pero desaparece cuando se usa |

Prueba agregar algunos botones y quick replies. Verás sus diferencias.

Canal de WeChat

Send Message

WeChat permite que el bot envíe textos con máximo 10 botones. Tipos de mensaje con WeChat:

TODO_IMAGE[image-20220703-054010.png]: revisar imagen desde Confluence.

Enviar Article

TODO_IMAGE[image-20220703-054026.png]: revisar imagen desde Confluence.

Así se ve en el chat:

TODO_IMAGE[image-20220703-054045.png]: revisar imagen desde Confluence.

Enviar Mini Program

También puedes enviar mini-programs asociados con tu cuenta oficial.

TODO_IMAGE[image-20220703-054115.png]: revisar imagen desde Confluence.

Canal de WhatsApp

Send Message

Tipos de mensaje con WhatsApp:

TODO_IMAGE[image-20220703-054131.png]: revisar imagen desde Confluence.

El botón en WhatsApp es un poco diferente al de Facebook. Un botón en Facebook puede presionarse varias veces, mientras que en WhatsApp solo una vez.

Tipos de mensaje soportados

OneChat soporta el envío de los siguientes tipos de mensajes de WhatsApp:

• Template Message: mensajes predefinidos aprobados por WhatsApp. Los usuarios pueden crear nuevas plantillas directamente en OneChat o sincronizar plantillas aprobadas existentes.

• Single Product Message: muestra un solo producto de un Facebook Catalog. Requiere Facebook Catalog ID y Retail ID.

• Multiple Products Message: muestra hasta 30 productos de un Facebook Catalog. Requiere Facebook Catalog ID y separa los productos con comas.

• Catalog Message: muestra una lista de productos de un Facebook Catalog. Requiere Retail ID, body text y footer.

• List Message: presenta una lista de opciones para que los usuarios elijan. Requiere capturar la selección del usuario y dirigir el flow según la opción elegida.

• WhatsApp Flow: crea un WhatsApp flow para automatizar el envío de mensajes e interacciones con usuarios.

Nota: vincular tu número de WhatsApp con tu Facebook Catalog es obligatorio para enviar mensajes relacionados con productos, como Single Product, Multiple Products y Catalog Message.

Enviar un Template Message

• Crear o sincronizar plantilla: en la sección Bot Content de OneChat, puedes crear una nueva plantilla directamente bajo "Message Templates" en OneChat o sincronizar plantillas aprobadas existentes haciendo clic en el botón "Sync".

TODO_IMAGE[AD_4nXc5ukCz1RacLU_r9WNUueD2nsLrWLhuuLtZ19lhvovz8iuQ5WZnG5KErKLY5OruziqU_CBv0tUuLtjJtKPOHkE8Ht_1]: revisar imagen desde Confluence.

• Usar en el flow: en "Message node", selecciona "Others" y agrega "(WhatsApp) Template Message" a tu flow de OneChat.

TODO_IMAGE[AD_4nXfPNW5e9aQKKGTQ6LmFNt5OKaXhV7CMni8NnvcSqin8WckS6QOjEDYohbMr1uoO3msA38qzkHmlNGrb5A0W62uBPjqu]: revisar imagen desde Confluence.

• Seleccionar plantilla: elige la plantilla deseada desde el menú desplegable.

TODO_IMAGE[AD_4nXfq8Z_s0R8VJa5_XBVyTusbUET2b_3LagPDBK5TbDYpLoIDvS3d20BNHxdHZwg1-Jqp0GsO52moksKH-XjL67uDg-us]: revisar imagen desde Confluence.

• Personalizar (opcional): si la plantilla incluye variables, puedes personalizar el contenido del mensaje.

Enviar Single Product Messages

• Requisito de Facebook Catalog: necesitas un Facebook Catalog para estos tipos de mensaje.

• Usar en el flow: en "Message node", selecciona "Others" y agrega "(WhatsApp) Single Product" a tu flow de OneChat.

TODO_IMAGE[AD_4nXfzZL4KYSu0lRO3TVn8C8Kuo5Ca3IqEkeqN9gyZGBRrRqZYDOW_F25y98vR7Cj2mRq7gZ317S1VrVpfqKkgLuT4zSPO]: revisar imagen desde Confluence.

• Catalog ID y Retail ID: localiza tu Facebook Catalog ID.

• Identifica el Retail ID, que es el content ID del feed de tu catálogo de productos.

• Inserta la información del mensaje: proporciona Retail ID, body text y footer text para tu Catalog Message.

TODO_IMAGE[AD_4nXcChzEpsTLQOm_RQnVFHU4qGvOaeDZDTJSMRixFdPTiFbNwwnEkHI-_P-ejivpfwK3XPxcDpOCgGHcuhMX-froLvDnq]: revisar imagen desde Confluence.

Nota: debes vincular tu número de WhatsApp con tu Facebook Catalog antes de enviar mensajes de productos.

Enviar Multiple Product Messages

• Requisito de Facebook Catalog: necesitas un Facebook Catalog para estos tipos de mensaje.

• Usar en el flow: en "Message node", selecciona "Others" y agrega "(WhatsApp) Multiple Products" a tu flow de OneChat.

TODO_IMAGE[AD_4nXdiSTjk9SEX-vcpkE2zRlsc2WL3pbEWj48qtYOkYqbuOW_j77x1O3EpKF89R5XqZ2UkIW3sO2oh2Hyqyl0pSQrSWZhz]: revisar imagen desde Confluence.

• Catalog ID y Retail ID: localiza tu Facebook Catalog ID.

• Identifica el Retail ID, que es el content ID del feed de tu catálogo de productos.

• Inserta la información del mensaje: proporciona Retail ID, body text, header y footer text para tu Catalog Message.

TODO_IMAGE[AD_4nXcCsW8IU4FXs8yzeVn0ToKZfdf1_49NG1QU-SopZu2-Bq_1ndS9i5GogxG63XtskPDvdWmmDlhMtVs4v9JMCKlnjIDF]: revisar imagen desde Confluence.

Nota: debes vincular tu número de WhatsApp con tu Facebook Catalog antes de enviar mensajes de productos.

Enviar Catalog Message

• Usar en el flow: en "Message node", selecciona "Others" y agrega "(WhatsApp) Catalog Message" a tu flow de OneChat.

TODO_IMAGE[AD_4nXfbkOvqu0zfROLMxfM6i_FcGv47E18RxBuuiZ7KHnqBHORCh4sk58eTS0hgDPJcm9xcI_ZhzLFdoNVbU4UVWEJp-Os5]: revisar imagen desde Confluence.

• Catalog ID y Retail ID: localiza tu Facebook Catalog ID.

• Identifica el Retail ID, que es el content ID del feed de tu catálogo de productos.

• Inserta la información del mensaje: proporciona Retail ID, body text y footer text para tu Catalog Message.

TODO_IMAGE[AD_4nXfBl0goLxNdiJY89sfFzkd307LlC05qK32gKMj3LUAkClQP5xoFCG1zrptWIKkQl2Uez5rxFBw_DTr1Oa-OQdh0D9zC]: revisar imagen desde Confluence.

Enviar List Message

• Usar en el flow: en "Message node", selecciona "Others" y agrega "(WhatsApp) List Message" a tu flow de OneChat.

TODO_IMAGE[AD_4nXcUJUF-gxS34RditJSc-ioVBATwVXW0d7J_RGOJgKFPkyoW9QgLaKpwb3zXbr63K5_PrMyp6QRki-JY7L-fNJkJUE2F]: revisar imagen desde Confluence.

• Definir list items: selecciona los list items que quieres incluir en tu List Message.

TODO_IMAGE[AD_4nXfKsqvUJ1w-RvidkHs1hxlpedCmZZMRmz_XH-VdpRIKoR3rMSCuw_EziVYywMHvdVvrrOa76hirBh8mubtXfYp0smYp]: revisar imagen desde Confluence.

• Capturar selección del usuario: es crucial capturar la opción elegida por el usuario desde la lista.

TODO_IMAGE[AD_4nXfWMiOlXikyV6xi0RCvdTtMZ0rjordoby7RlKVQYoIXH7axnprwpzXyKfpqbku7fqjnY4id3U5f5fKBVNze86FRRIho]: revisar imagen desde Confluence.

• Enrutamiento condicional: usa un Condition Block para revisar la selección del usuario y dirigir el flow según corresponda.

TODO_IMAGE[AD_4nXfAgswMy5e4eDmn8St38_kR3_Y6A2MrHyZXsuBmqvflFlSIi1FuZv5ZENkVxpCekdECtv4FFDBXLJ-EaA18LDS1eMpM]: revisar imagen desde Confluence.

Nota: los pasos 2 a 4 para List Messages son esenciales para asegurar que el flow responda correctamente según la interacción del usuario.

Enviar un WhatsApp Flow Message

• Usar en el flow: en "Message node", selecciona "Others" y agrega "(WhatsApp Cloud) WhatsApp Flow" a tu flow de OneChat.

TODO_IMAGE[AD_4nXdgD0rkey1XuEednBNKJwYUIvYtMH11UwWA9v39giF4ec-e6gGgjgkdTZG7SwqvKtJl09ALUsAozcRIaYnX1MSz-Vt0]: revisar imagen desde Confluence.

• Configura el WhatsApp flow que se enviará.

TODO_IMAGE[AD_4nXe4uEqj7wD36_T4WA_SAgwCO0dXxhmGzvUekyxkuUc-g0F8d9mAz6CoppCxSkNiqnXQRT5Sdo6i-ZoRLZBI8wW2iPI5]: revisar imagen desde Confluence.

Nota: consulta aquí la documentación de creación de WhatsApp Flow.

Advertencia: no uses el action node para enviar templates a bot users; esto generará un error "forbidden action". Para hacerlo, usa el message node.

TODO_IMAGE[AD_4nXfp-k89aoJFKs1uaCra3xiaWFT-AwzksDBuVBQ6ZR5s7XOlTiwIgx9Zmy9qhzmOPm59e7RpAOb2qHajoq88TM_57GKI]: revisar imagen desde Confluence.

Canal SMS

Send Message

El bot de SMS solo puede enviar texto e imagen.

TODO_IMAGE[image-20220703-054152.png]: revisar imagen desde Confluence.

Canal de voz

Send Message

Enviar texto / audio

TODO_IMAGE[image-20220703-054212.png]: revisar imagen desde Confluence.

Puedes hacer que el bot lea el texto con un idioma específico o grabar tu propio audio y subirlo.

En el canal de voz, también puedes proporcionar una audio URL directamente en el send message node.

Debes asegurarte de que la audio URL sea accesible públicamente, empiece con https y termine en .mp3.

También puedes usar la misma audio URL directamente en el question node.

Puedes encontrar más tipos de mensaje soportados para el canal de voz aquí: https://onechat-com-au.atlassian.net/wiki/spaces/UKB/pages/724926477/Voice+Channel#Voice-Flow.

Nota: para voice bot, puedes establecer un idioma predeterminado en el Green Start Point o configurarlo por separado para cada send message/question step.

OneChat creó una Mini-App llamada "VoiceMaker" usando una API de terceros que ofrece una conversión de texto a voz de mejor calidad. Descarga la Mini-App en la sección de integración. La documentación de "VoiceMaker" está en progreso.

Google My Business - Send Message

Tipos de mensaje con un flow de Google My Business:

TODO_IMAGE[image-20220703-054303.png]: revisar imagen desde Confluence.

Todos los tipos están cubiertos arriba; revisa los tipos de mensaje comunes para todos o algunos de los canales. Encuentra el tipo location en "Rich Media".

WhatsApp Contact

Envía una tarjeta de contacto al usuario, como un nombre y número telefónico. En el step Send Message, haz clic en + Add Item, selecciona Others y luego elige (WhatsApp) Contact. Agrega esto bajo la sección WhatsApp Channel, incluyéndolo en la lista Supported Message Types.

TODO_IMAGE[image-20260613-035535.png]: revisar imagen desde Confluence.

WhatsApp/Messenger Call Permission

Envía una solicitud pidiendo al usuario permiso para recibir una llamada de voz. Está soportado tanto en WhatsApp como en Messenger. En el step Send Message, haz clic en + Add Item, selecciona Others y luego elige (WhatsApp/Messenger) Call Permission. Agrega esto bajo las secciones WhatsApp Channel y Facebook Channels.

TODO_IMAGE[image-20260613-035557.png]: revisar imagen desde Confluence.