¡Bienvenido a nuestra página de documentación! Aquí encontrarás toda la información que necesitas para instalar y poner en marcha nuestra plataforma de manera exitosa. Desde instrucciones detalladas hasta consejos útiles, estamos aquí para guiarte en cada paso del proceso. Comienza tu viaje hacia una comunicación más eficiente y efectiva con nuestra plataforma. ¡Explora la documentación y comienza a aprovechar al máximo todas nuestras funciones!
WhatsApp
Las configuraciones que presentamos a continuación están relacionadas con la aplicación WhatsApp. Aquí te mostramos cómo integrar por completo WhatsApp Business con la plataforma de Vchat By StudioVainilla.
En Panel de soporte > Configuración > WhatsApp > Configuración de API en la nube > Clave secreta, ingrese una cadena aleatoria, luego vaya a https://developers.facebook.com/apps y seleccione su aplicación. Haga clic en Agregar producto y agregue WhatsApp, luego vaya a WhatsApp > Configuración y en URL del Webhook ingrese la URL que obtiene en el Panel de soporte > Configuración > WhatsApp > API de la nube > URL de configuración. En Verificar token, ingrese la clave secreta que ingresó anteriormente en el Panel de soporte. Haga clic en Verificar y guardar, haga clic en Campos de Webhook > Administrar, habilite los siguientes campos de Webhook: mensajes [messages].
Para verificar la integración, simplemente vaya a https://developers.facebook.com y seleccione su aplicación. Desde allí, haga clic en “WhatsApp” en el menú de la izquierda y luego seleccione “Configuración de API”. Copie el ID del número de teléfono y péguelo en Panel de soporte > Configuración > WhatsApp > Configuración de API en la nube > ID del número de teléfono. Ingrese el número de teléfono deseado en el campo “Para”, como su número personal de WhatsApp, y envíe un mensaje de prueba. Verifique su cuenta de WhatsApp y envíe una respuesta, que luego debería aparecer en el Panel de soporte. Para responder al número de prueba del Panel de soporte, copie el “Token de acceso temporal” y péguelo en Panel de soporte > Configuración > WhatsApp > Configuración de API en la nube > Token.
Para activar la integración de WhatsApp para todos los números de teléfono y agregar un número de teléfono activo, consulte las siguientes pautas. En Panel de soporte > Configuración > WhatsApp > Configuración de API en la nube > Token, ingrese el token de acceso permanente y siga las instrucciones a continuación para obtenerlo.
Visite https://business.facebook.com y vaya al menú de la izquierda > Configuración > Configuración comercial, luego vaya a Usuarios > Usuarios del sistema para ver el usuario administrador del sistema o cree uno nuevo. Abra el usuario y haga clic en Agregar activos, luego seleccione la aplicación utilizada para la integración de la API de WhatsApp y marque Desarrollar aplicación o Control total. El usuario del sistema debe ser administrador. Si no ve la opción, haga clic en Configuración empresarial.
Haga clic en el menú de la izquierda > Aplicaciones y en Seleccionar activos y elija su aplicación, habilite Desarrollar aplicación o Control total y guarde.
En Usuarios > Usuarios del sistema, seleccione el usuario que acaba de crear y haga clic en Generar nuevo token, haga clic en Aplicaciones y seleccione la aplicación utilizada para la integración de la API de WhatsApp, establezca la caducidad del token en Nunca, habilite los siguientes permisos: whatsapp_business_management, whatsapp_business_messaging, business_management. Haga clic en Generar token y guarde. Pegue el token en Panel de soporte > Configuración > WhatsApp > API de la nube > Token.
Para agregar números de teléfono adicionales, puede hacerlo visitando https://developers.facebook.com, seleccionando su aplicación y navegando a Menú izquierdo > WhatsApp > Configuración de API. Para comenzar, haga clic en Agregar número de teléfono en la parte inferior y siga las instrucciones proporcionadas. Tenga en cuenta que si usa su número comercial actual de WhatsApp en el Panel de soporte, ya no podrá usarlo con su aplicación WhatsApp Business y deberá migrarlo siguiendo estas instrucciones. Después de activar el número, copie el ID del número de teléfono y péguelo en Panel de soporte > Configuración > WhatsApp > Configuración de API en la nube > ID del número de teléfono.
En cuanto a la política comercial de WhatsApp, no puede enviar mensajes de solicitud y marketing salientes a los usuarios finales. Los usuarios finales deben comunicarse con usted primero. Tienes 24 horas desde que se envió el mensaje del usuario final desde WhatsApp para responder el mensaje. Para comunicarte con un usuario que no te ha contactado antes o no ha estado en contacto durante más de 24 horas, debes optar por el mensaje de texto alternativo o la plantilla de mensaje de WhatsApp.
Reserva de mensajes de texto
Para habilitar el respaldo de mensajes de texto, debe configurar el SMS en Configuración > Notificaciones > Notificaciones de mensajes de texto.
Más detalles aquí
Plantillas de mensajes de WhatsApp
Una plantilla de mensaje de WhatsApp es un formato de mensaje que puede usar una y otra vez para enviar mensajes a los usuarios una vez que hayan optado por participar y hayan dado permiso a su aplicación para enviarles mensajes. No puede ingresar el mensaje original en la plantilla, debe usarlo para notificar al usuario de un nuevo mensaje e indicarle cómo verlo, por ejemplo, proporcionando un enlace a su sitio web donde se muestra el chat.
API de la nube de WhatsApp
Para obtener el nombre de la plantilla y administrar las plantillas, visite https://business.facebook.com y vaya al menú izquierdo > Configuración > Más configuraciones del sistema, luego vaya a Cuentas > Cuentas de WhatsApp > Configuración y haga clic en Administrador de WhatsApp.
En Idiomas de la plantilla, ingrese todos los códigos de idioma admitidos por su plantilla, separados por comas. Si no se encuentra un idioma, se utiliza el primer código de idioma. Lista de códigos de idioma aquí (copie solo el código de idioma, por ejemplo, it, es, en_US).
En Parámetros de encabezado y Parámetros de cuerpo, ingrese los campos de combinación admitidos separados por comas, p. {nombre_destinatario}, {parámetro_url_conversación}. La cantidad de parámetros ingresados aquí debe coincidir con la cantidad de parámetros de la plantilla. Utilice esta función si su plantilla utiliza valores dinámicos. El orden es importante, el primer campo de combinación se utilizará como primer parámetro de plantilla.
Enviar mensajes de plantilla a un usuario que no se ha puesto en contacto contigo antes
En Configuración > WhatsApp > Configuración de API en la nube > ID de cuenta comercial, ingrese su ID de cuenta comercial. Proporcione su ID de cuenta comercial, que puede obtener en https://developers.facebook.com. Elija su aplicación y vaya al menú de la izquierda > WhatsApp > Configuración de API.
Para enviar la plantilla a usuarios específicos, vaya a la sección Usuarios del tablero de soporte y elija los destinatarios previstos. Luego, haz clic en el ícono de WhatsApp ubicado en la esquina superior derecha.
Si está utilizando Twilio y tiene parámetros en su plantilla, ingrese los valores de los parámetros separados por comas en la sección Cuerpo.
Para más detalles haga clic aquí.
Mostrar un solo producto. Remplace id con el ID del catálogo y product_id con el ID del producto. Los atributos body y footer de página son opcionales.
Mostrar múltiples productos. Reemplace id con el ID del catálogo. Añade productos agrupándolos en secciones, a través de los atributos product_id_[A]_[B], reemplace [A] con el índice de sección, comenzando desde 1, reemplace [B] con el índice de producto, comenzando desde 1 para cada sección. También debes agregar el atributo section_[A]=”” para cada sección, reemplace [A] con el índice de la sección. los atributos head and body son requeridos, footer es opcional.
Cuando el usuario envía el pedido, la información del pedido se envía a la URL especificada en Configuración > WhatsApp > Webhook order. La página en esa URL debe procesar el pedido y enviar un mensaje al usuario a través de la función API de PHP sb_whatsapp_send_message().
Si no recibe mensajes de WhatsApp, asegúrese de no asignar las conversaciones de WhatsApp a un departamento y de que el número de WhatsApp utilizado para las pruebas no sea el número de teléfono de un administrador o agente de la Junta de soporte. Además, asegúrese de configurar correctamente la URL del webhook de WhatsApp.
Si no puede enviar mensajes, debería aparecer un error en el área de administración cuando intente enviar un mensaje al usuario.
No podemos brindar soporte para la configuración de Twilio o 360dialog, incluidos todos los problemas relacionados.
No podemos brindarle asistencia para que se apruebe su cuenta de WhatsApp o su plantilla de mensaje de WhatsApp.
Las conversaciones y mensajes de WhatsApp son compatibles con enrutamiento y cola.
Si está probando con el sandbox y después de 72 horas ya no puede enviar mensajes a su número de teléfono, debe vincular nuevamente su número de teléfono a su sandbox.
Puedes enviar mensajes enriquecidos a WhatsApp. Si envía chips, botones o selecciona mensajes enriquecidos, con más de 3 opciones, puede usar el atributo shortcode whatsapp=”Tu menú de mensajes” para configurar el texto del menú de mensajes de WhatsApp.
Usar el número de teléfono que se ha registrado antes con WhatsApp Business desde el celular
Para solicitar la Verificación de la API de WhatsApp, es necesario emplear un número que no esté vinculado a ninguna cuenta de WhatsApp en uso.
Puedes optar por un número de teléfono que esté registrado en la aplicación de WhatsApp para Android, iPhone o en la versión empresarial de WhatsApp.
No obstante, para registrar este número en la API de WhatsApp Business, deberás seguir estos pasos para desvincular la cuenta de WhatsApp asociada con dicho número.
Una vez que un número de teléfono se registra en la API de WhatsApp Business, ya no puede utilizarse con WhatsApp Business ni con la aplicación de consumo de WhatsApp. Es posible actualizar un número de teléfono a la API de WhatsApp Business, pero no es posible revertir este proceso.
Con iCloud, puedes crear y restaurar copias de seguridad de tu historial de chats de WhatsApp.
Nota:
No almacenamos los historiales de chats de WhatsApp en nuestros servidores.
Los archivos y mensajes que guardes en una copia de seguridad no estarán protegidos por el cifrado de extremo a extremo de WhatsApp.
No podemos recuperar los mensajes que se hayan borrado.
Crear una copia de seguridad en iCloud
Copia de seguridad manual
Puedes crear una copia de seguridad de tus chats de forma manual en cualquier momento.
En WhatsApp, ve a Configuración > Chats > Copia de seguridad > Realizar copia ahora.
Copia de seguridad automática
Puedes activar las copias de seguridad automáticas y programadas. Para ello, pulsa Copia automática y elige la frecuencia que desees.
De este modo, se creará una copia de seguridad de tus archivos y chats en tu cuenta de iCloud. Puedes elegir si deseas incluir videos en la copia de seguridad o no. El proceso para crear una copia de seguridad de tus mensajes en iCloud puede demorar un poco, ya que depende del tamaño de la copia y la calidad de tu conexión a Internet.
Requisitos
Debes iniciar sesión con el Apple ID que usas para acceder a iCloud.
Debes tener iOS 12 o una versión posterior y la función iCloud Drive debe estar activada.
Debes tener espacio suficiente tanto en tu iPhone como en iCloud. El espacio disponible debe ser de al menos 2.05 veces el tamaño de la copia de seguridad tanto en tu teléfono como en tu cuenta de iCloud.
Si quieres limitar el uso de datos móviles, es aconsejable que uses iCloud para crear copias de seguridad solo mediante una conexión Wi-Fi.
Exportar el historial de chats
Si quieres guardar un chat, puedes enviarte el historial de chat por correo electrónico. Para ello, sigue estos pasos:
Abre el chat individual o grupal que quieras guardar.
Pulsa el nombre del contacto o el asunto del grupo.
Pulsa Exportar chat.
Selecciona si quieres Adjuntar archivos o enviar el chat por correo electrónico Sin archivos.
Abre la aplicación Mail. Para ver más opciones, también puedes pulsar Más.
Ingresa tu dirección de correo electrónico y pulsa Enviar.
Tanto los agentes como los usuarios pueden recibir notificaciones mediante mensajes de texto cuando llegue un mensaje nuevo. Twilio proporciona notificaciones por mensajes de texto. Twilio es un servicio pago, pero económico y puedes usar la versión de prueba para probar las notificaciones de mensajes de texto de forma gratuita.
Activación
Vaya a https://www.twilio.com y cree una nueva cuenta.
Verifica tu numero de telefono.
Complete el formulario y elija SMS.
Una vez en el panel, haga clic en Obtener un número de prueba y luego en Elegir este número.
Ingrese al área de administración del Panel de soporte, vaya a Configuración > Notificaciones > Notificaciones de mensajes de texto y pegue el SID de la cuenta, el token de autenticación, el número de prueba (o un número de teléfono comprado). Encuentre todos los detalles en el panel de Twilio.
Si está utilizando la versión de prueba, puede enviar notificaciones solo a números verificados. Ingrese al panel de Twilio y haga clic en el botón izquierdo # (Números de teléfono), luego haga clic en Identificadores de llamadas verificados y agregue su número de teléfono.
Para comenzar a utilizar el servicio en vivo y recibir mensajes de texto en el Panel de soporte, debe comprar un número de teléfono. Después de la compra, vaya a Números de teléfono > Administrar > Números activos, haga clic en su número e ingrese la URL del Panel de soporte, consígala en el Panel de soporte > Configuración > Notificaciones > Notificaciones de mensajes de texto > Obtener URL de configuración.
Estás listo.
Información
Asegúrese de que sus agentes y administradores tengan asignado un número de teléfono para que los mensajes de texto de los agentes puedan enviarse a los números apropiados.
Todos los números de teléfono deben tener el código de país que comience con el símbolo + (por ejemplo, +52 para México
Puede obtener el número de teléfono del usuario a través del formulario de registro, mensaje de seguimiento, mensaje de suscripción o mediante código corto [correo electrónico]. Puede ingresar manualmente el teléfono del usuario desde el área de administración o mediante API.
Cuando un usuario envía su primer mensaje, si la conversación está asignada a un departamento, se envía un mensaje de prueba solo a los agentes asignados a ese departamento, si la conversación está asignada a un agente específico, se envía un mensaje de texto solo a ese agente , de lo contrario se envía un mensaje de texto y un correo electrónico a todos los agentes que no están en línea en ese momento. Los mensajes de texto posteriores se envían únicamente al último agente de la conversación.
Las notificaciones por mensaje de texto se envían solo si el último agente de la conversación está desconectado.
Si está utilizando la aplicación Dialogflow y Configuración > Inteligencia artificial > Toma de control humana está activa, no se envían mensajes de texto si el chatbot conoce la respuesta.
Para utilizar la función de ID del remitente, ingrese el nombre del remitente en el campo Número del remitente.
[card image="URL" header="TITLE" descripción="Lorem ipsum dolor sit amete" link="URL" link-text="Compra" extra="$599" target="_blank"]</pre >
Tarjeta de llamado a la acción con una imagen, título, descripción, enlace y más.
Control deslizante
[slider image-1="URL" header-1="TÍTULO" descripción-1="Lorem ipsum dolor sit amete" link-1="URL" link-text-1="Compra" extra-1= "$599" image-2="URL" header-2="TÍTULO" descripción-2="Lorem ipsum dolor sit amete" link-2="URL" link-text-2="Compra" extra-2="$599 " target="_blank"]
Deslizador de tarjetas de llamado a la acción con una imagen, título, descripción, enlace y más. Puede agregar hasta 10 diapositivas.
Imágenes deslizantes
[slider-images imágenes="URL,URL,URL"]
Control deslizante de imágenes.
Fichas
[opciones de chips="A,B,C"]
Lista de botones.
Botones
[botones opciones="A,B,C"]
Lista de botones.
Seleccionar
[seleccione opciones="A,B,C"]
Lista desplegable de opciones.
Entradas
[inputs value="A,B,C" button="Enviar ahora"]
Lista de entradas de texto.
Correo electrónico
[nombre de correo electrónico="true" apellido="true" teléfono="true" teléfono-required="false" placeholder=""]
Formulario para recoger el correo electrónico y el número de teléfono del usuario. Todos los atributos son opcionales. Configuraciones de seguimiento utilizadas como valores predeterminados. Agregue el atributo required-messaging-apps=”true” para obligar a los usuarios a proporcionar su correo electrónico y teléfono en las aplicaciones de mensajería.
Registro
[registro]
Formulario de inscripción.
Horario
[horario]
Horario.
Artículos
[enlace de artículos="https://board.support/articles-demo"]
Artículos con área de búsqueda. El atributo enlace se utiliza como mensaje alternativo para mensajes de Facebook Messenger, WhatsApp y Telegram.
Calificación
[rating label-positive="Ayuda" label-negative="No útil" label="Calificar y reseñar" Success-negative=""]
Formulario de calificación de agentes. Para que el shortcode de calificación funcione en WhatsApp, Messenger, Telegram, debes usar Dialogflow y el chatbot, crear una nueva Intent con rating como Contexto de entrada</b >, nada como Contexto de salida, una lista de los mensajes más comunes del usuario para una calificación positiva como Frases de entrenamiento(por ejemplo, bueno, positivo) y { “calificación” : 1, “force-message”: true } como carga útil personalizada respuesta. Para la calificación negativa, cree una nueva intención con el mismo contexto, pero reemplace las frases de entrenamiento y la carga útil personalizada por { “rating”: -1, “force-message”: true } . El shortcode debe incluir también un título o mensaje.
Lista
[valores de lista="A,B,C"]
Lista de texto.
Lista doble
[valores de lista="A:X,B:Y,C:Z"]
Lista de texto con títulos.
Imagen de lista
[lista-imagen valores="URL:A,URL:B,URL:C"]
Lista de texto con títulos e imágenes.
Tabla
[encabezado de tabla="A,B,C" valores="A:B:C,A:B:C,A:B:C"]
Mostrar un enlace o abrir un artículo. El atributo target=”_blank” es opcional y abre el enlace en una nueva ventana. El atributo style=”link” es opcional y cambia el diseño del botón. Para abrir un artículo al hacer clic, el valor del enlace debe ser #article-ID, reemplace ID con el ID del artículo.
Vídeo
[tipo de vídeo=”youtube” id=”0TImic4N1ko” height=”350″]
Muestra un vídeo de YouTube o Vimeo. El valor del atributo tipo puede ser youtube o vimeo. El atributo id es el ID del vídeo, obtenlo de la URL. El atributo height es opcional y establece la altura del vídeo en px.
Comas
Si sus textos incluyen comas, deberá reemplazar todas las comas con los caracteres \,.
Parámetros globales
Todos los mensajes enriquecidos admiten los siguientes parámetros:
Parámetros
Descripción
id="123"
El ID del mensaje enriquecido (utilizado también para guardar los datos JSON).
title="ABC"
El título del mensaje enriquecido.
message="ABC"
La descripción enriquecida del mensaje que aparece debajo del título.
success="ABC"
El mensaje que aparece cuando el usuario completa y envía el mensaje enriquecido. La entrada del usuario se adjunta a este mensaje.
configuration="ABC"
Campo adicional para valores adicionales opcionales.
Integrar Facebook Messenger e Instagram DM con Vchat
Desde Ajustes > haz clic en Messenger.
Haz clic en “Iniciar sincronización”.
Completa la sincronización seleccionando al menos 1 página de Facebook e ingresa la información que se devuelve en Configuración > Messenger > Páginas de Facebook.
¡Listo! Todos los mensajes enviados a las páginas de Facebook y cuentas de Instagram que hayas seleccionado aparecerán en el área de administración de conversaciones de Vchat.