Paso Send Message

Tomemos Facebook como ejemplo. Otros flujos comparten procesos similares, donde la principal diferencia es el tipo de mensaje.

Unos pocos pasos sencillos para enviar tu primer mensaje:

1. haz clic en el punto de inicio verde

2. en el panel de edición, "Select Next Step"

3. elige el paso "Send Message"

4. haz clic en el paso "Send Message"

5. haz clic en el mensaje de tipo texto

6. ingresa tu mensaje

7. "Publish"

¡Eso es todo! ¡Probemos!

Haz clic en "Preview" en la barra de navegación y en "Open the flow in Messenger". Haz clic en "Get Started" si es la primera vez que hablas con el bot.

Función Preview: ten en cuenta que la función "Preview" no es compatible con todos los canales. Los canales que admiten "Preview" son: Facebook, Telegram, WhatsApp, Line y Viber. Para los canales sin Preview, busca "talk to bot" en la documentación para obtener orientación.

¡Felicidades! Tu bot ya está funcionando. 🤖🤖

Déjame mostrarte algunos detalles más sobre el paso Send Message. Estos son los tipos de mensaje comunes para todos/algunos de los canales.

Enviar texto / variable

OneChat se ha integrado con Grammarly para ayudarte a perfeccionar tu redacción.

Insertar valor de campo personalizado y emoji

Dondequiera que veas "</>", puedes insertar emojis o valores de variables en el texto.

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

Enviar imagen / audio / video / archivo

Hay 4 formas en total:

• subir desde tu computadora (tamaño limitado)

| Tipo de medio |

| Tamaño máximo de carga |

| --- |

| --- |

| video |

| 10MB |

| audio |

| 5MB |

| archivo |

| 5MB |

| otros (p. ej. imagen) |

| 2MB |

Desde un enlace URL (recomendado)

Puedes buscar imágenes en línea y copiar sus enlaces URL directos. Pero este enlace directo podría cambiar. Como alternativa, puedes subir fotos a tu servidor u otros almacenamientos de fotos de terceros como Imgur:, y luego obtener tus enlaces URL directos desde ahí. Un enlace URL directo significa que apunta a una foto específica, no a un sitio web, y termina en .jpg o .png, etc. Toma como ejemplo el enlace de la imagen anterior.buscar en la galería de GIFs

OneChat te proporciona una galería de GIFs, puedes buscar aquí lo que necesites.desde Library

Library es el lugar donde puedes ver todas las fotos, GIFs, audios y videos que has subido anteriormente. Así no necesitas volver a subir el mismo medio, solo encuéntralo en tu biblioteca.

Enviar Card

La Card se usa para mostrar una serie de información de forma ordenada, como información de productos. Hay 4 factores 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 uno de los otros factores: 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. Muestra automáticamente todos los elementos de una variable JSON. Consulta Action Step - JSON Operation si no sabes qué es una variable JSON.

1. elige primero una variable JSON

2. haz clic en "</>" o escribe "{{" en el cuadro de texto

3. elige "ITEM" para obtener un elemento de muestra de la variable JSON

Valor en la variable JSON:

Valor en "ITEM":

Los "Sample data" sirven para completar rápidamente el campo "JSON Path". Por ejemplo, como se muestra en la imagen, haz clic en la fila "price" y "$.price" aparecerá en el propio "JSON Path". Esto significa que aquí estamos mostrando el precio de cada elemento. Si no aparece ningún dato de muestra, puedes completar la ruta tú mismo escribiendo "$.", que se refiere a cada elemento de la variable JSON, seguido de la clave de un valor.

Formato de valor

Además, para números como porcentajes y precios, así como para valores de fecha y hora, OneChat tiene distintos formatos listados para ti. Por ejemplo, en la imagen anterior, el valor del precio es "5" y después de elegir un formato "F03", el bot lo mostrará como "$5". Mientras tanto, el valor en la variable sigue siendo el número "5", para que puedas usarlo en cálculos matemáticos o comparaciones de condiciones sin problemas.

Claves ocultas

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

| Nombre de la clave |

| Descripción |

| --- |

| --- |

| INDEX |

| índice del elemento comenzando desde 1 |

| KEY |

| nombre de la clave del elemento |

| VALUE |

| valor del elemento = el propio elemento |

#### Ejemplo de INDEX

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

Resultado de la prueba:

#### Ejemplo de KEY/VALUE

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

Esto es lo que obtendrás al usar las tres claves:

Resultado de la prueba:

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 querer poner un botón "Buy" o "Select" aquí en caso de que estés listando algunos productos u opciones.

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

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

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

Por ejemplo, agreguemos un paso Send Message y busquemos el campo del sistema "SELECT":

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

2. en la ruta JSON, agrega el nombre de la clave si es necesario. En este caso, mostremos el nombre del elemento seleccionado. Entonces agrega ".name" después de la ruta.

Verás esto cuando lo pruebes:

Enviar contenido dinámico

El contenido dinámico 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 manera diferente cada vez. De esta forma, 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 en gran medida de otros servidores.

Por ejemplo, si tienes tu propio algoritmo de IA para analizar las preguntas de los usuarios y calcular la respuesta correspondiente en tu servidor, en ese caso puedes enviar la pregunta en la solicitud API. Y el servidor puede generar una respuesta basada en la pregunta. Finalmente, el servidor envía la respuesta de vuelta a OneChat para mostrarla a tus usuarios.

Un mensaje de respuesta puede contener varios mensajes, botones y respuestas rápidas con acciones. Incluso puedes aplicar acciones simples, como agregar una etiqueta, directamente en el JSON de respuesta.

• Consulta Action Step - External Request para ver cómo enviar una solicitud API,

• y Response Format para obtener orientación sobre el formato de mensajes.

Enviar ubicación

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

Ingresa el nombre de tu ubicación, pega los datos y agrega una etiqueta si es necesario. Una etiqueta proporciona información adicional, como piso o número de habitación.

Enviar producto de Ecommerce

Consulta Ecommerce para ver cómo configurar y usar el sistema de ecommerce integrado.

Enviar texto de depuración de mensajes

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

Acceso a Debug Text:

Ve a Send Message y selecciona Debug Text

Agregar testers:

• Ve a Tools -> Testers-> New Tester

• Identifica a los usuario(s) que servirán como testers de tu chatbot.

• Agrega al/los usuario(s) a la lista de testers.

Enviar mensajes de depuración:

• Una vez agregados los testers, activa la vista previa del flujo donde incorporaste Send Message Debug Text.

• Durante la vista previa, el texto de depuración será visible para los testers agregados.

Canales de Facebook

Send Message

Facebook permite que el bot envíe textos con un máximo de 3 botones y 10 respuestas rápidas.

Enviar texto con botón y respuesta rápida

La diferencia entre button y quick reply en Facebook Messenger:

| Tipo |

| Uso |

| --- |

| --- |

| button |

| una vez enviado, permanece siempre en la conversación para ser presionado |

| quick reply |

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

Intenta agregar algunos botones, respuestas rápidas y pruébalo. Verás sus diferencias.

Canal de WeChat

Send Message

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

Enviar artículo

Así es como se ve en el chat:

Enviar Mini Program

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

Canal de WhatsApp

Send Message

Tipos de mensaje en WhatsApp:

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

Tipos de mensaje compatibles

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

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

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

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

4. Catalog Message: muestra una lista de productos de un Facebook Catalog. Requiere un Retail ID, texto del cuerpo y pie de página.

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

6. WhatsApp Flow: crea un flujo de WhatsApp para automatizar el envío de mensajes y las interacciones con los usuarios.

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

Enviar un Template Message

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

1. Usar en el flujo: en "Mensage node", selecciona "Others" y luego "(WhatsApp) Template Message" dentro de tu flujo de OneChat.

1. Seleccionar plantilla: elige la plantilla deseada del menú desplegable.

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

Enviar mensajes de producto único

1. Requisito de Facebook Catalog: necesitas un Facebook Catalog para estos tipos de mensajes.

2. Usar en el flujo: en "Mensage node", selecciona "Others" y luego "(WhatsApp) Single Produtct" dentro de tu flujo de OneChat.

Catalog ID y Retail ID:

• Ubica tu Facebook Catalog ID.

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

1. Ingresa la información de tu mensaje: proporciona el Retail ID, el texto del cuerpo del mensaje y el texto del pie de página para tu Catalog Message.

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

Enviar mensajes de múltiples productos

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

• Usar en el flujo: en "Mensage node", selecciona "Others" y luego "(WhatsApp) Multiple Products" dentro de tu flujo de OneChat.

• Catalog ID y Retail ID:

Ubica tu Facebook Catalog ID.

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

• Ingresa la información de tu mensaje: proporciona el Retail ID, el texto del cuerpo del mensaje, el encabezado y el texto del pie de página para tu Catalog Message.

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

Enviar un Catalog Message

1. Usar en el flujo: en "Mensage node", selecciona "Others" y luego "(WhatsApp) Catalog Message" dentro de tu flujo de OneChat.]

1. Catalog ID y Retail ID:

Ubica tu Facebook Catalog ID.

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

1. Ingresa la información de tu mensaje: proporciona el Retail ID, el texto del cuerpo del mensaje y el texto del pie de página para tu Catalog Message.

Enviar un List Message

1. Usar en el flujo: en "Mensage node", selecciona "Others" y luego "(WhatsApp) List Message" dentro de tu flujo de OneChat.

1. Definir elementos de la lista: selecciona los elementos que deseas incluir en tu List Message.

1. Capturar la selección del usuario: es fundamental capturar la opción elegida por el usuario en la lista.

1. Enrutamiento condicional: usa un bloque Condition para verificar la selección del usuario y dirigir el flujo en consecuencia.

Nota: Los pasos 2-4 para los List Message son esenciales para asegurar un flujo correcto según la interacción del usuario.

Enviar un mensaje de WhatsApp Flow

1. Usar en el flujo: en "Mensage node", selecciona "Others" y luego "(WhatsApp Cloud) WhatsApp Flow" dentro de tu flujo de OneChat.

1. Configura el flujo de WhatsApp que se enviará.

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

Advertencia: No uses el nodo de acción para enviar plantillas a los usuarios del bot, ya que esto generará un error de "forbidden action". Para hacerlo, usa el nodo de mensaje.

Canal de SMS

Send Message

El bot de SMS solo puede enviar texto e imagen.

Canal de voz

Send Message

Enviar texto / audio

Puedes hacer que el bot lea el texto en voz alta con un idioma especificado o grabar tu propio audio y subirlo.

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

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

También puedes usar la misma URL de audio directamente en el nodo de pregunta.

Puedes encontrar más tipos de mensaje compatibles con el canal de voz aquí.

Nota: para el bot de voz, puedes establecer un idioma predeterminado en el punto de inicio verde o configurarlo por separado para cada paso send message/question.

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

Google My Business - Send Message

Tipos de mensaje en el flujo de Google My Business:

Todos los tipos están cubiertos arriba; por favor revisa los tipos de mensaje comunes para todos/algunos de los canales. Encuentra el tipo de ubicación en "Rich Media".