Conéctate con la API de WhatsApp Cloud

El registro integrado es una forma práctica de registrar tu remitente en la API de WhatsApp Business directamente desde el sitio web de OneChat. Después del registro, puedes comenzar a usar la API con la ayuda de OneChat para mejorar la experiencia de interacción con tus clientes.

Se recomienda ampliamente que inicies WhatsApp Cloud API con un administrador comercial de Meta verificado.

Sin embargo, no es obligatorio hacerlo.

Puedes crear un nuevo administrador comercial de Meta durante el proceso si todavía no tienes uno.

Requisitos previos

Antes de comenzar a usar la API de WhatsApp Business, necesitarás lo siguiente:

• Una cuenta de Facebook.

• Acceso de administrador a tu cuenta de Meta Business Manager. Si no tienes una cuenta de Meta Business Manager, puedes crear una durante el proceso de registro integrado. Además, la cuenta comercial de Meta no debe estar bloqueada (aquí puedes ver si hay restricciones en tu cuenta comercial de META).

• Tarjeta de crédito (Mastercard / Visa → ¡No American Express!)

• Un número de teléfono que pueda registrarse como remitente. Este número no debe estar conectado a ninguna cuenta de WhatsApp (privada o API de WhatsApp Business). Necesitarás acceso a este número para recibir un SMS o una llamada de voz para la verificación. Si tienes una cuenta existente, puedes encontrar instrucciones sobre cómo eliminarla aquí.

Instrucciones en video

En este video, puedes encontrar una guía paso a paso sobre cómo configurar WhatsApp Cloud:

TODO_VIDEO[eda9678873]: reemplazar este video con un recurso oficial de OneChat.

Ni40

Instrucciones paso a paso

Paso 1: Inicia sesión con Facebook

Para comenzar el proceso, inicia sesión en la plataforma OneChat, ve al "dashboard", haz clic en "WhatsApp Cloud" en la barra lateral izquierda y luego en el botón "Connect WhatsApp Cloud":

En la ventana emergente, inicia sesión con tu cuenta de Facebook o selecciona la cuenta con la que ya hayas iniciado sesión en tu navegador.

Paso 2: Crea o selecciona una cuenta de Meta Business Manager

Puedes seleccionar una cuenta existente de Meta Business Manager sobre la que tengas permisos de administrador o crear una nueva cuenta de Meta Business Manager. Para crear una nueva cuenta, deberás preparar la siguiente información:

• Nombre legal de la empresa

• Número de teléfono de la empresa

• Sitio web de la empresa

• Correo electrónico de la empresa

• País

• Dirección corporativa

• Ciudad

• Estado/provincia/región

Ten en cuenta que el nuevo administrador comercial de Meta creado estará "sin verificar", por lo que se te recomendará verificarlo lo antes posible. Puedes seguir las instrucciones aquí.

Paso 3: Crea el perfil de WhatsApp Business

1. Ingresa el nombre de tu cuenta de WhatsApp Business (WABA)

Tu audiencia no verá esta información en tu perfil de WhatsApp.

2. Ingresa el nombre visible de tu perfil de WhatsApp Business

Nombres visibles

Los nombres visibles deben ser revisados por Meta, lo cual es uno de los factores importantes para aumentar el límite de números.

Un nombre visible debe tener una marca coherente con fuentes externas (por ejemplo, el sitio web o marketing de una empresa).

Los nombres visibles deben estar relacionados con tu negocio y no deben infringir las políticas de comercio y negocio de WhatsApp. Además, el nombre visible debe cumplir con las directrices de nombres visibles de WhatsApp.

3. Elige una categoría comercial de la lista

4. Ingresa una descripción para tu negocio

Puedes editar la descripción en cualquier momento, incluso después de la verificación del remitente.

Paso 4: Verifica el número de WhatsApp Business

1. Ingresa el número de teléfono que quieres usar como tu número comercial de WhatsApp. Ten en cuenta que este número de teléfono no puede usar ningún servicio de WhatsApp.

2. Elige uno de los siguientes métodos de verificación:

• SMS

• Llamada de voz

Una vez que tu número sea verificado,

serás redirigido a la pantalla de abajo, y al hacer clic en el botón "finish", volverás a la plataforma OneChat.

Paso 5: Completa el registro de tu número

Una vez que seas redirigido a la plataforma OneChat, verás la pantalla de abajo y deberás hacer clic en el botón "Sync Numbers":

y verás los números que acabas de registrar dentro de la plataforma OneChat. De forma predeterminada, el estado es "Paused", por lo que debes cambiarlo a "Active".

De forma predeterminada, si vas a "WhatsApp manager" y luego a "Phone numbers", notarás que el estado es "Pending" como se muestra en la captura de pantalla de abajo:

Ahora, si vuelves a OneChat y haces clic en "settings" como se muestra en la captura de pantalla de abajo, y luego haces clic en "Register number", podrás registrar tu número:

Y una vez que completes el registro, verás que el estado de tu número de teléfono ahora es "Connected".

¡Y ahora tu bot está listo para probarse!

Pero antes de comenzar a hacer pruebas, es muy importante configurar la facturación y verificar tu administrador comercial de Meta (no es obligatorio, pero sí muy recomendable).

Antes de enviar cualquier mensaje de plantilla para probar o pasar tu chatbot a producción, conecta una tarjeta de crédito válida en la sección de facturación dentro de WhatsApp Manager.

Además, existe el riesgo de que tu número o cuenta de administrador comercial de Meta sea restringida si no tienes un administrador comercial de Meta verificado.

Paso 6: Haz una verificación rápida de conexión

Una vez que el número de WhatsApp esté conectado, puedes hacer clic en "Create flow" y crear un flujo simple en tu flujo principal.

Haz clic en el botón "Publish" para publicar el flujo y luego envía cualquier mensaje desde tu número personal de WhatsApp a este número de WhatsApp Cloud API.

Deberías recibir el mensaje de texto de vuelta. Si ves el mensaje, entonces la conexión está funcionando correctamente. Tu bot responde y está funcionando bien.

Ahora, puedes ir a "content", "Message Templates", y hacer clic en el botón "Sync". Si no ves ningún mensaje de error, entonces el mensaje de plantilla de WhatsApp también está funcionando.

Ten en cuenta que no se sincronizará realmente ninguna plantilla a OneChat cuando apenas empiezas. También puedes hacer clic en " + New Template" y crear un nuevo mensaje de plantilla de WhatsApp directamente desde OneChat.

Por último, puedes ir a "WhatsApp manager" en tu administrador comercial de Meta y conectar una tarjeta de crédito válida a la facturación, y luego podrás probar el envío de un mensaje de plantilla de WhatsApp a un usuario de WhatsApp.

Si tu método de pago es válido, el mensaje de plantilla debería entregarse sin ningún problema.

Si completaste todas las pruebas, entonces tu API de WhatsApp Cloud está conectada correctamente.

Configuración de WhatsApp Cloud

OneChat ofrece algunas configuraciones que pueden ayudarte a administrar tu API de WhatsApp fácilmente; si haces clic en los 3 puntos en WhatsApp Cloud, encontrarás las siguientes opciones:

• Health Check

• Business Verification Status

• Check payment method

• Phone numbers

• Message Templates

• Catalog

• Two Factor Authentication

• De-Register number

Proceso de verificación comercial de BM (opcional)

Si no has completado el proceso de verificación comercial, estarás limitado a asociar solo dos números de teléfono y podrás tener un máximo de 250 conversaciones por día.

Si se excede este límite, la cuenta se cancelará automáticamente después de 15 días.

Sin embargo, durante este período, aún puedes probar el servicio. Una vez que tu negocio haya sido verificado, podrás asociar WABA con hasta 20 números de teléfono y el límite de conversaciones aumentará a 1000 por día.

Verificar método de pago

Lo primero que debes hacer es conectar una tarjeta de crédito válida a tus números WABA. Si no conectas una tarjeta válida y comienzas a enviar mensajes de plantilla de WhatsApp, verás el siguiente error:

[ { "error_code": 141006, "error_description": "There is an error with the payment method.", "possible_solution": "There was an error with your payment method. Please add a new payment method to the account." } ]

Solo necesitas conectar una tarjeta de crédito válida a tus números WABA.

Deberás ir al administrador comercial de Meta y encontrar la cuenta de WhatsApp.

Y hacer clic en "Payment Settings"

Puedes configurar tu método de pago en https://business.facebook.com/billing_hub/payment_methods y revisar el método de pago de WhatsApp.

Health Check

Si haces clic en la verificación de estado, verás la captura de pantalla de abajo:

Esto te dará una visión general del estado de tu número de teléfono, el estado de WABA y el estado de la cuenta comercial de Meta.

Números de teléfono

Una cuenta de WhatsApp Business (WABA) necesita un número de teléfono válido dedicado al uso de la plataforma WhatsApp Business.

Esta guía explica cómo elegir números de teléfono, agregarlos a tu cuenta y las limitaciones de envío relacionadas. Una vez que hagas clic en esta opción, serás redirigido a "phone numbers" en tu WhatsApp Manager, y el estado de tu número de teléfono caerá en una de las siguientes categorías:

El estado se clasifica de la siguiente manera:

• Connected: El remitente funciona normalmente.

• Flagged: Este estado ocurre cuando la calificación de calidad del remitente alcanza un estado bajo (rojo). Durante este estado, no puedes aumentar el nivel del límite de mensajería. Si la calificación de calidad mejora a un estado medio o alto dentro de los 7 días desde el día en que el estado del remitente cambió a Flagged, el estado cambia a Connected. Si la calificación de calidad no mejora, el estado del remitente vuelve a Connected, pero el límite de mensajería disminuye al siguiente nivel inferior. El nivel más bajo para empresas verificadas es Tier 1.

• Restricted: Este estado ocurre cuando el remitente alcanza el límite de mensajería. Durante la fase Restricted, no puedes enviar mensajes salientes (notificaciones) hasta que se restablezca la ventana de 24 horas. Solo puedes responder a mensajes iniciados por los usuarios finales.

• Pending: Puedes hacer clic en "registrate numbers" para conectar tus números de teléfono.

Agregar un número de teléfono a una WABA

Actualmente, cada Meta Business Manager verificado puede tener hasta 20 números de teléfono, independientemente del número de WABAs.

Si deseas agregar un nuevo número, por favor agrégalo mediante el proceso de registro integrado.

Cambiar el nombre visible

Cada número de teléfono tiene su propio nombre visible, y este nombre debe estar relacionado con el nombre de tu empresa o marca. El nombre visible será revisado por Meta. Puedes ir a Meta para cambiar el nombre.

Eliminar un número de teléfono de una WABA

Para eliminarlo por completo, sigue los pasos a continuación:

1. En Business Manager, ve a la página de configuración de tu empresa.

2. Ve a Settings > Business Settings > WhatsApp Accounts > WhatsApp Manager > Phone Numbers.

3. Desde WhatsApp Manager, encuentra el número de teléfono que deseas eliminar. Haz clic en el ícono de papelera debajo de Delete en la parte superior derecha.

• Solo un administrador comercial de la cuenta de WhatsApp Business puede eliminar un número de teléfono.

• Un número no puede eliminarse si la empresa ha enviado mensajes de pago en los últimos 30 días usando ese número.

• Una vez que un número ha sido eliminado de la plataforma WhatsApp Business, puede volver a usarse en la app de WhatsApp, o puede registrarse nuevamente en la plataforma WhatsApp Business. Ten en cuenta que se aplican reglas diferentes a teléfonos eliminados que habían sido bloqueados por la plataforma WhatsApp Business.

Plantillas de mensajes

Este enlace te redirigirá a la sección de plantillas de WhatsApp en WhatsApp Manager, y podrás crear y enviar plantillas directamente en WhatsApp Manager; una vez que la plantilla sea aprobada, puedes ir a OneChat para sincronizarla de regreso a OneChat.

También puedes hacer clic en el botón "New Template" en OneChat y crear y enviar la plantilla directamente dentro de OneChat.

Catálogo

Las empresas pueden habilitar catálogos para compartir productos con sus clientes usando mensajes de producto múltiple y producto único, o mostrar sus productos y servicios a sus clientes en la app de WhatsApp, permitiéndoles explorarlos y agregar artículos a su carrito sin salir de la conversación, brindando una experiencia de compra fluida y conveniente.

Si haces clic en el enlace "Catalog", serás redirigido a WhatsApp Manager, luego haz clic en "Catalog" y en "Choose a Catalog"; en el menú desplegable, selecciona el catálogo que deseas conectar.

Haz clic en "View catalog" si quieres ver o administrar el catálogo, haz clic en "Connect Catalog", y entonces estos números WABA quedarán conectados al catálogo.

Si deseas sincronizar el catálogo de productos de Facebook con el ecommerce nativo de OneChat, puedes ir a "Integrations", luego a la categoría "E-commerce", y después hacer clic en "Facebook Business" e iniciar sesión con tu cuenta de Facebook.

Después de iniciar sesión con tu cuenta de Facebook, serás redirigido de vuelta a OneChat, y luego deberás hacer clic en el botón "List Business Catalogs".

Encuentra el catálogo que está vinculado a tus números WABA y haz clic en el botón "Facebook → Local"; entonces los productos de tu catálogo se sincronizarán de regreso a OneChat Ecommerce → Products.

Si abres cualquiera de los productos sincronizados en OneChat Ecommerce → products, verás que el título del producto, la descripción, las imágenes y los precios están sincronizados con los mensajes del catálogo de Facebook.

Necesitarás el retailID para enviar mensajes del catálogo de productos de WhatsApp; puedes encontrar el retailID sincronizado con el SKU en la sección de productos.

Consulta más información sobre cómo construir una experiencia de compra nativa de ecommerce en WhatsApp aquí.

Actualizar el nombre visible de WhatsApp

Tu empresa puede cambiar los nombres visibles hasta 4 veces en un período de 30 días. Una vez que termine ese período de 30 días, comenzará un nuevo período de 30 días y tu empresa podrá nuevamente cambiar los nombres visibles hasta 4 veces durante ese nuevo período.

Si deseas actualizar tu nombre visible de WhatsApp, debes ir al administrador comercial de Meta y luego a WhatsApp Manager.

Haz clic en el enlace azul y selecciona el número de teléfono al que deseas actualizar el nombre visible, luego haz clic en el ícono "Edit" como se muestra en la captura de pantalla de abajo.

En la sección Edit Display Name, ingresa un nuevo nombre visible. Los nombres visibles deben estar relacionados con tu negocio y usar una marca coherente con fuentes externas (por ejemplo, tu sitio web).

Tu nombre visible deberá ser aprobado por WhatsApp antes de que esté disponible un certificado actualizado. Después de que sea aprobado, vuelve a registrar tu número y entonces tu nombre visible quedará activo.

Cómo agregar números de teléfono adicionales en OneChat

Primero deberás agregar los nuevos números de teléfono en tu cuenta de WhatsApp Manager desde el administrador comercial de Meta.

Meta tiene límites de números de teléfono para WhatsApp Manager. Si has alcanzado los límites, deberás contactar a Meta para aumentarlos.

Una vez que el nuevo número de teléfono haya sido agregado a tu cuenta de WhatsApp Manager, puedes ir a OneChat y hacer clic en "Sync numbers"

Entonces verás el nuevo número agregado en OneChat.

En la configuración, primero deberás "Verify the phone number" y luego "Register the number"

Puedes hacer clic primero en "Verify the phone number".

Esta opción solo está disponible para el nuevo registro integrado. El método anterior de conexión con app privada no tiene esta opción.

Luego puedes elegir SMS o Voice para verificar el número de teléfono.

Después de que el número de teléfono haya sido verificado, puedes continuar con los pasos para registrar el número aquí.

Cómo migrar un número de WhatsApp a WhatsApp Cloud en OneChat

Puedes leer el proceso de migración a continuación directamente desde Meta.

https://developers.facebook.com/docs/whatsapp/business-management-api/guides/migrate-phone-to-different-waba

¿Cuáles son los posibles errores comunes en el flujo de registro integrado?

Consulta aquí los errores comunes oficiales de Meta.

A. Errores de creación de cuenta de Business Manager

Ocurrió un error al procesar esta solicitud. Inténtalo de nuevo más tarde.

Este es el error más poco claro y requiere asistencia adicional. La creación de la cuenta comercial pudo haber fallado por varias razones.

==> Si recibes este error, usa una cuenta activa de Facebook o contacta a Soporte para resolverlo.

Has alcanzado el límite de la cantidad de empresas que puedes crear en este momento.

Existe un límite en la cantidad de cuentas comerciales que puedes crear.

==> Usa una cuenta comercial existente o elimina/cierra cuentas comerciales no utilizadas.

Tu cuenta de Facebook es demasiado nueva para crear una cuenta comercial. Inténtalo de nuevo en una hora.

Las cuentas nuevas de Facebook deben esperar un tiempo antes de poder crear una cuenta de Business Manager.

=> Usa una cuenta activa de Facebook existente o espera unas horas antes de usar tu cuenta nueva. La nueva cuenta de Facebook puede usarse activamente durante el período de espera.

Limitamos la frecuencia con la que puedes publicar, comentar o hacer otras cosas en un período determinado para ayudar a proteger a la comunidad del spam. Puedes intentarlo de nuevo más tarde.

Tu cuenta de Facebook fue marcada por comportamiento sospechoso.

==> Necesitas usar una cuenta activa de Facebook existente y sin problemas previos.

Ya no tienes permitido usar productos de Facebook para anunciar. No puedes publicar anuncios, administrar recursos publicitarios ni crear nuevas cuentas de anuncios o comerciales.

No puedes crear nuevas cuentas de Business Manager debido a comportamiento sospechoso previo.

==> Usa una cuenta activa de Facebook existente y sin problemas previos.

Tu cuenta de pago está deshabilitada

Tu cuenta de pago fue deshabilitada debido a comportamiento sospechoso previo.

==> Contacta a Facebook para recibir ayuda aquí

Un usuario solo puede crear un usuario comercial a la vez

Solo puedes crear una única cuenta comercial dentro de un período de tiempo determinado.

==> Usa una cuenta comercial existente para completar la incorporación.

El nombre que elegiste para tu negocio no es válido. Considera usar xxx.

==> Agrega un nombre válido que coincida con el nombre de tu negocio.

B. Errores de creación de cuenta de WhatsApp Business

El usuario no tiene permiso para crear cuentas de WhatsApp Business.

No tienes el nivel de permiso de administrador necesario para crear cuentas de WhatsApp bajo la cuenta comercial que seleccionaste.

==> Obtén acceso de administrador a la cuenta comercial para continuar o selecciona una cuenta sobre la que sí tengas permisos de administrador.

Esta cuenta de WhatsApp Business no está disponible para usarse.

Si ves este mensaje de error y no puedes seleccionar la cuenta de WhatsApp Business que deseas, se debe a una de las siguientes razones:

• No tienes permiso para administrar esa cuenta de WhatsApp Business

• Esa cuenta de WhatsApp Business ya está administrada por apps privadas u otra plataforma

La solución a este problema es solicitar permisos de administrador para la cuenta de WhatsApp Business o desconectarla de otras plataformas.

Solo puedes crear una cantidad limitada de cuentas de WhatsApp Business antes de que se complete la verificación de tu empresa y de tu cuenta de WhatsApp. Puedes crear cuentas adicionales después de ser verificado.

Intentaste crear varias cuentas de WhatsApp Business bajo una empresa no verificada.

==> Solo puedes crear cuentas adicionales de WhatsApp Business cuando la verificación comercial y las comprobaciones de la cuenta de WhatsApp estén completas. Inicia la verificación comercial para la cuenta visitando Business Manager.

No podemos verificar la cuenta comercial de Facebook que seleccionaste. Regresa a la pantalla anterior para seleccionar una cuenta diferente, o ve a Facebook Business Manager para obtener soporte.

La cuenta comercial de Facebook seleccionada no cumple con nuestras políticas para usar la API de WhatsApp Business y no pudo verificarse.

==> Visita tu cuenta de Business Manager para obtener más información sobre esta cuenta comercial de Facebook. Si tu solicitud de verificación comercial fue rechazada, deberías haber recibido una notificación por correo electrónico con las razones detalladas. Puedes intentar reenviar tu verificación comercial si crees que fue un error, o crear una cuenta de WhatsApp Business usando una cuenta comercial de Facebook que ya haya sido verificada.

Algo salió mal. Tendrás que contactar a soporte e intentarlo de nuevo.

Esto podría ser un problema intermitente de WhatsApp.

==> Puedes volver a intentar el flujo en unos minutos.

Ya vinculaste la cantidad máxima de números de teléfono permitidos para esta cuenta comercial. Elimina un número de teléfono para continuar o solicita números adicionales.

De forma predeterminada, Meta solo permite un máximo de 2 números de teléfono para una cuenta de WhatsApp Business; si necesitas más números, debes comunicarte con el soporte de Meta para aumentar los límites permitidos.

Según las políticas de Meta: "Los portafolios comerciales están limitados inicialmente a 2 números de teléfono comerciales registrados, pero este límite puede aumentarse hasta 20.

Si tu empresa ha sido verificada, o si abres 1,000 o más conversaciones iniciadas por la empresa en un período móvil de 30 días usando plantillas con una calificación de alta calidad, determinaremos si tu uso de la API justifica un aumento del límite de números de teléfono."

Obtén más información sobre los límites de números de teléfono aquí.

C. Errores de configuración del teléfono

Este número de teléfono ya existe en tu lista de números de teléfono.

Estás intentando agregar un número de teléfono que ya existe en tu cuenta de WhatsApp Business.

==> Regresa al flujo o reinícialo para seleccionar el número de teléfono existente.

Este número está registrado en una cuenta existente de WhatsApp. Para usar este número, desconéctalo de la cuenta existente. Luego, vuelve a esta página y vuelve a ingresar el número. Nota: puede tomar hasta 3 minutos para que el número esté disponible.

El número de teléfono ya estaba registrado en nuestra plataforma (es decir, WhatsApp Messenger, WhatsApp Business App o WhatsApp Business API).

==> Ve a la configuración de "WhatsApp Cloud" y desregistra el número si quieres usarlo, o registra un número nuevo.

Tu nombre verificado infringe las directrices de WhatsApp. Edita tu nombre verificado e inténtalo de nuevo.

El nombre usado para el perfil comercial del número de teléfono no cumple con nuestras directrices.

==> Consulta las directrices de Display Name e inténtalo de nuevo.

Algo salió mal. Tendrás que contactar a soporte e intentarlo de nuevo.

Hubo un problema al crear el perfil comercial del número de teléfono.

==> Vuelve a ingresar el nombre correcto del perfil comercial de acuerdo con las directrices y los demás detalles.

D. Errores de verificación del teléfono

La propiedad del número de teléfono ya está verificada.

==> Este número de teléfono ya ha sido verificado. Puedes intentar actualizar la página para ver el cambio aplicado.

Tu número de teléfono no parece ser válido. Revísalo nuevamente o inténtalo otra vez después de 5 minutos.

Se ingresó un número de teléfono incorrecto o no admitimos números con este formato.

==> Asegúrate de que el número esté operativo y verificado por un proveedor de telecomunicaciones. Actualmente no admitimos números de respuesta de voz interactiva (IVR).

Has adivinado demasiadas veces.

Para bloquear el spam, el sistema solo permite una cantidad limitada de intentos de verificación.

==> Debes esperar aproximadamente 12 horas antes de volver a intentarlo. Después de este período de espera, vuelve al flujo y selecciona las cuentas y números de teléfono existentes para verificarlos nuevamente.

Hubo un error al verificar este número de teléfono. Inténtalo de nuevo más tarde.

Hubo un problema con el código de verificación.

==> Inténtalo de nuevo más tarde.

Has solicitado tu código demasiadas veces.

Para bloquear el spam, el sistema solo permite una cantidad limitada de intentos de verificación.

==> Limitamos la cantidad de veces que puedes solicitar un código dentro de un período determinado. Vuelve al flujo después del tiempo especificado y selecciona las cuentas y números de teléfono existentes para solicitar un código nuevamente.