Guia de canal

Conectar WhatsApp en Ventor

Esta es la guia especifica de WhatsApp dentro del centro de documentacion de canales. Aqui se explica el flujo completo con Meta y la vinculacion final dentro de Ventor.

Seccion 1

Resumen del flujo

Esta pagina corresponde unicamente a la guia de WhatsApp. Aqui veras el flujo completo desde la autenticacion con Meta hasta la confirmacion final del canal en Ventor.

Guia especifica de WhatsApp

Si buscas la documentacion de otros canales, entra al centro de documentacion de Conectar canales. Cada canal se publicara en su propia pagina para evitar mezclar flujos distintos.
1

Haz click en 'Conectar WhatsApp' dentro de Ventor

Se abrira una ventana de Meta para autenticar tu cuenta y continuar la configuracion.
2

Inicia sesion y elige el activo correcto

Meta te pedira confirmar tu cuenta de Facebook y seleccionar o crear los activos comerciales necesarios.
3

Sigue el flujo segun tu tipo de numero

Puedes crear una nueva cuenta de WhatsApp Business para un numero liberado o conectar un numero que ya usa WhatsApp Business App en modo coexistencia.
4

Finaliza siempre desde Ventor

Al final veras pantallas de confirmacion y carga. Cuando vuelvas a Ventor, completa el cierre de la vinculacion para dejar el canal operativo.
Seccion 2

Prerrequisitos

Antes de iniciar, revisa que tengas acceso a todo lo necesario para completar el flujo sin interrupciones.

1

Tener una cuenta de Facebook

Si aun no la tienes, entra a facebook.com y usa la opcion Create new account para completar tus datos.
2

Acceso al numero de telefono que vas a conectar

Lo necesitaras para recibir el codigo por SMS o para escanear el QR si vienes desde WhatsApp Business App.
3

Definir que tipo de conexion haras

Numero liberado si el telefono no esta vinculado a ninguna cuenta de WhatsApp, o coexistencia si ya esta activo en WhatsApp Business App.

Si usas un numero nuevo

El numero debe estar liberado, es decir, no debe estar vinculado actualmente a una cuenta de WhatsApp.

Ir a la pagina de conectar canales en Ventor

Antes de iniciar el flujo con Meta, entra a la pagina de Conectar canales en Ventor desde el panel:

ventorchat.com/panel/configuraciones/canales

Dentro de esa pantalla veras la tarjeta de WhatsAppy el boton Conectar WhatsApp, que es el punto de partida para abrir la ventana de Meta.

Pantalla de Ventor en la seccion conectar canales con el boton Conectar WhatsApp
Este es el boton dentro de Ventor que inicia todo el flujo de conexion con Meta.
Seccion 3

Inicio del flujo con Meta

Todo empieza cuando presionas el boton 'Conectar WhatsApp' en Ventor. Desde ahi Meta abre la ventana segura donde se hace la autenticacion y la configuracion inicial.

1. Ingreso a la cuenta de Facebook

Al hacer click en Conectar WhatsApp, se abrira una ventana emergente de Facebook para iniciar sesion con la cuenta que administrara la conexion.

Ventana de Meta para iniciar sesion con Facebook
Si al hacer login Meta te redirige al Facebook completo, cierra la ventana emergente y vuelve a intentar la conexion desde Ventor.

2. Pantalla de bienvenida de la integracion

Despues del login, Meta mostrara una pantalla de bienvenida donde explica que la cuenta de WhatsApp se conectara con Ventor.

Pantalla de bienvenida de Meta para conectar WhatsApp con Ventor
Esta pantalla confirma que estas entrando al flujo correcto de integracion con Ventor.
Seccion 4

Seleccion de activos comerciales

En este punto Meta te pedira escoger o crear los activos de negocio necesarios. Aqui se define cual de los dos caminos seguira tu conexion.

En la seleccion de activos comerciales deberas escoger la cuenta de negocio y la cuenta de WhatsApp Business que vas a usar. Si aun no tienes una, Meta te permitira crearla en el momento.

Seleccion de activos comerciales dentro del flujo de Meta
Aqui tambien veras las dos opciones de conexion para la cuenta de WhatsApp Business.
OpcionCuando elegirlaConsideraciones importantes
Crear una cuenta de WhatsApp BusinessCuando el numero esta liberado y no esta vinculado a ninguna cuenta de WhatsApp.Es la mejor opcion para empezar desde cero con un numero nuevo para API.
Conecta una app de WhatsApp BusinessCuando el numero ya esta activo en WhatsApp Business App y deseas conectarlo en modo coexistencia.Tiene restricciones. Lo recomendado es seguir respondiendo desde Ventor y no desde la app para mantener una operacion ordenada en API.

Regla practica para elegir bien

Si tu numero aun no esta en WhatsApp, usa Crear una cuenta de WhatsApp Business. Si tu numero ya funciona en WhatsApp Business App, usa Conecta una app de WhatsApp Business.
Seccion 5

Flujo A: crear una cuenta para un numero liberado

Este camino aplica cuando el telefono no esta vinculado a ninguna cuenta de WhatsApp y quieres conectarlo directamente como canal API en Ventor.

Paso 1. Completa la informacion general del activo comercial

Meta te pedira los datos principales del activo comercial antes de continuar con la configuracion del numero.

Formulario de Meta para completar la informacion del activo comercial
Completa los datos del negocio con la informacion real de la cuenta que administrara el canal.

Paso 2. Agrega el numero nuevo y define el nombre publico

En esta pantalla debes elegir Agregar un numero nuevo, ingresar el telefono y completar el nombre visible de WhatsApp.

Pantalla para agregar un numero nuevo de WhatsApp Business
No elijas 'Usar solo un nombre visible': esa opcion crea un numero de prueba y no te permitira escribir como un canal real.

No uses el numero de prueba

Debes escoger Agregar un numero nuevo. La opcion Usar solo un nombre visible sirve para pruebas y no para operar el canal normalmente.

Paso 3. Verifica el numero por SMS

Meta enviara un codigo de verificacion por mensaje de texto al numero ingresado. Necesitaras ese codigo para completar la conexion.

Pantalla de Meta para ingresar el codigo de verificacion por SMS
Ten el telefono a mano para recibir el codigo y continuar sin cerrar el flujo.
Seccion 6

Flujo B: conectar un numero que ya usa WhatsApp Business App

Este camino usa coexistencia. Permite conectar a Ventor un numero que ya esta en WhatsApp Business App, pero conviene conocer sus limites antes de seguir.

Restricciones de coexistencia

Los mensajes enviados directamente desde WhatsApp Business App no son reconocidos por Ventor. Para evitar desorden en la operacion y posibles alertas de calidad, lo recomendable es manejar las conversaciones desde Ventor una vez conectada la API.

Paso 1. Completa los datos del activo comercial

Igual que en el flujo anterior, primero tendras que completar la informacion del negocio asociada a la cuenta de WhatsApp.

Formulario de Meta para configurar el activo comercial en coexistencia
Usa los datos del negocio que administrara el numero conectado.

Paso 2. Ingresa el numero vinculado a WhatsApp Business App

Meta te pedira el telefono que ya esta activo en WhatsApp Business App para enlazarlo con la API.

Pantalla de Meta para ingresar el numero ya vinculado a WhatsApp Business App
Ingresa exactamente el mismo numero que hoy usas en la app.

Paso 3. Escanea el codigo QR desde tu celular

Luego aparecera un QR. En el celular donde tienes la app te llegara un mensaje de Facebook Business con un boton para ir directo a la camara y escanearlo.

Si prefieres hacerlo manualmente dentro de la app, entra a: Boton de 3 puntos > Ajustes > Cuenta > Plataforma para empresas.

Codigo QR de Meta para activar la coexistencia con WhatsApp Business App
Escanea el QR desde el mismo celular donde esta instalado WhatsApp Business App.

Paso 4. Confirma la cuenta de WhatsApp Business

Una vez escaneado el QR, Meta mostrara la pantalla de confirmacion de la cuenta conectada.

Pantalla de confirmacion de cuenta de WhatsApp Business en coexistencia
Si los datos se ven correctos, continua para terminar la vinculacion.
Seccion 7

Finalizacion de la conexion

Aunque los dos caminos son diferentes, ambos terminan en las mismas pantallas finales de Meta antes de volver a Ventor.

Confirmacion de conexion con Ventor

Meta te mostrara una pagina confirmando que la cuenta se esta vinculando con Ventor.

Pantalla de Meta confirmando la conexion con Ventor
Esta pantalla indica que el flujo ya esta entrando en la etapa final.

Pantalla de carga de la vinculacion

Luego aparecera una pantalla de espera mientras Meta termina de procesar la conexion.

Pantalla de carga mientras Meta termina la vinculacion
Es normal que esta etapa tome unos segundos antes de mostrar la confirmacion final.

Confirmacion final antes de volver a Ventor

Al terminar, veras la confirmacion final de Meta. Desde ahi debes volver a Ventor para cerrar el proceso.

Pantalla de confirmacion final de Meta para la vinculacion de WhatsApp
El proceso no queda completo hasta finalizar la conexion del canal desde Ventor.

Ultimo paso obligatorio

Siempre debes hacer click en finalizar conectar el canaldesde Ventor. Si cierras el flujo antes de ese paso, la vinculacion puede quedar incompleta.
Seccion 8

Verificacion final en Ventor

Cuando Ventor termine de registrar el canal, recibiras una confirmacion y podras abrir la vista del canal conectado para validar que todo este correcto.

Mensaje de exito en Ventor despues de conectar WhatsApp
Al finalizar, Ventor mostrara el mensaje de confirmacion y te ofrecera abrir el canal conectado.
1

Espera el mensaje de confirmacion en Ventor

Ese mensaje indica que la vinculacion termino correctamente del lado de la plataforma.
2

Abre la ventana del canal conectado

Ventor te redirigira a la vista del canal de WhatsApp para revisar el estado de la conexion.
3

Haz una validacion rapida

Verifica que el numero, el nombre y el estado del canal se vean correctos antes de empezar a operar.

Recomendacion operativa

Una vez que el canal ya este conectado, procura concentrar la gestion de mensajes en Ventor, especialmente si vienes del flujo de coexistencia con WhatsApp Business App.

¿Listo para conectar tu canal de WhatsApp?

Sigue esta guia durante la vinculacion para evitar errores comunes y completar el flujo de Meta sin perder ningun paso importante.

Ir a Ventor