WhatsApp API Oficial
El registro incorporado es una manera cómoda de registrar tu remitente en la API de WhatsApp Business directamente desde el sitio de NicoChat. Después del registro, puedes empezar a usar la API con la ayuda de NicoChat para mejorar la experiencia de relación con tus clientes.
Sin embargo, no es obligatorio hacerlo.
Puedes crear un nuevo Meta Business Manager durante el proceso, si aún no tienes uno.
Requisitos previos
Antes de empezar 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 incorporado. Además, la cuenta de Meta Business no debe estar bloqueada ( aquí puedes ver si hay alguna restricción en tu cuenta de Meta Business)
- Tarjeta de crédito (Mastercard / Visa → Sin American Express)
- Un número de teléfono que pueda registrarse como remitente . Este número no puede estar conectado a ninguna cuenta de WhatsApp (personal o WhatsApp Business API). Necesitarás acceso a ese número para recibir un SMS o una llamada de voz de verificación. Si ya tienes una cuenta, puedes consultar aquí las instrucciones para eliminarla.
Instrucciones en vídeo
En este vídeo encontrarás una guía paso a paso de cómo configurar WhatsApp Cloud:
Próximamente
Instrucciones paso a paso
Paso 1: inicia sesión con Facebook
Para iniciar el proceso, inicia sesión en la plataforma NicoChat, ve al “Panel”, haz clic en “WhatsApp Cloud” en la barra lateral izquierda y luego en el botón “Conectar WhatsApp Cloud”:
En la ventana emergente, inicia sesión en tu cuenta de Facebook o selecciona la cuenta con la que ya has 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 en 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 comercial
- Sitio web comercial
- Dirección de correo electrónico comercial
- País
- Dirección corporativa
- Ciudad
- Estado / provincia / región
Ten en cuenta que el nuevo Meta Business Manager creado quedará “ no verificado ”. Te recomendamos que verifiques tu Meta Business Manager lo antes posible. Puedes seguir las instrucciones en Verificación de Negocios de Meta .
Paso 3: crea un perfil comercial de WhatsApp
1. Introduce el nombre de tu cuenta comercial de WhatsApp (WABA)
Tu público no verá esta información en tu perfil de WhatsApp.
2. Introduce el nombre para mostrar de tu perfil comercial de WhatsApp
Los nombres para mostrar deben ser revisados por Meta, y ese es uno de los factores importantes para aumentar el límite de mensajes del número.
Un nombre para mostrar debe tener una identidad de marca coherente con fuentes externas (por ejemplo, el sitio web o el material de marketing de la empresa).
Los nombres para mostrar deben estar relacionados con tu empresa y no pueden infringir las políticas comerciales ni empresariales de WhatsApp . Además, el nombre para mostrar debe cumplir con las directrices de nombres para mostrar de WhatsApp .
3. Elige una categoría de negocio de la lista
4. Introduce una descripción para tu empresa
Puedes editar la descripción en cualquier momento, incluso después de la verificación del remitente.
Paso 4: verifica el número comercial de WhatsApp
- Introduce el número de teléfono que deseas usar como número comercial de WhatsApp. Ten en cuenta que ese número no puede estar en uso en ningún servicio de WhatsApp.
- Elige uno de los siguientes métodos de verificación:
- SMS
- Llamada de voz
Una vez que tu número esté verificado,
serás redirigido a la pantalla de abajo. Haz clic en el botón “Finalizar” y volverás a la plataforma NicoChat.
Paso 5: completa el registro de tu número
Una vez que seas redirigido a la plataforma NicoChat, verás la pantalla de abajo y deberás hacer clic en el botón “Sincronizar Números”:
y verás los números que acabas de registrar en la plataforma NicoChat. De forma predeterminada, el estado es “Pausado”; debes cambiar el estado a “Activo” .
De forma predeterminada, si vas a “WhatsApp Manager” y luego a “Números de teléfono”, notarás que el estado es “Pendiente”, como se ve en la imagen de abajo:
Ahora, de vuelta en NicoChat, haz clic en “Configuración”, como se ve en la imagen de abajo, haz clic en “Registrar número” y registra tu número :
Y una vez completado el registro, verás que el estado de tu número de teléfono es “Conectado” .
¡Y ahora tu canal está listo para probarse!
Pero antes de empezar a probar, es muy importante configurar tu facturación y verificar tu Meta Business Manager (no es obligatorio, pero es muy recomendable).
Además, corres el riesgo de que tu número o tu cuenta de Meta Business Manager sean restringidos si no tienes un Meta Business Manager verificado.
Paso 6: haz una comprobación rápida de la conexión
Una vez que el número de WhatsApp esté conectado, puedes hacer clic en “Crear flujo” y crear un flujo simple dentro de tu flujo principal.
Haz clic en el botón “Publicar” para publicar el flujo y luego envía cualquier mensaje desde tu número personal de WhatsApp a ese número de la WhatsApp Cloud API.
Deberías recibir el mensaje de texto de vuelta. Si ves el mensaje, la conexión está funcionando. Tu canal está respondiendo y funcionando bien.
Ahora puedes ir a “Contenido”, “Plantillas de mensaje” y hacer clic en el botón “Sincronizar”. Si no aparece ningún mensaje de error, las plantillas de mensaje de WhatsApp también están funcionando.
Ten en cuenta que ninguna plantilla de mensaje se sincronizará con NicoChat cuando estés empezando. También puedes hacer clic en “+ Nueva plantilla” y crear una nueva plantilla de mensaje de WhatsApp directamente desde NicoChat.
Por último, puedes ir a “WhatsApp Manager” en tu Meta Business Manager, conectar una tarjeta de crédito válida a la facturación y luego probar el envío de una plantilla de mensaje de WhatsApp a un usuario de WhatsApp.
Si tu método de facturación es válido, la plantilla de mensaje debería entregarse sin problemas.
Si has hecho todas las pruebas, tu WhatsApp Cloud API está conectada correctamente.
Configuración de WhatsApp Cloud
NicoChat ofrece algunas configuraciones que te ayudan a gestionar tu API de WhatsApp con facilidad. Si haces clic en los 3 puntos en WhatsApp Cloud, encontrarás las opciones de abajo:
- Verificación de Salud
- Estado de verificación comercial
- Verificar el método de pago
- Números de teléfono
- Plantillas de mensajes
- Catálogo
- Autenticación de dos factores
- Cancelar el registro del número
Proceso de verificación comercial del BM (opcional)
Si no has completado el proceso de Verificación Empresarial, 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 supera ese límite, la cuenta se cancelará automáticamente después de 15 días.
Sin embargo, durante ese período aún puedes probar el servicio. Una vez verificada tu empresa, podrás asociar la WABA con hasta 20 números de teléfono y el límite de conversaciones aumentará a 1.000 por día.
Verificar el 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 has conectado una tarjeta válida y empiezas a enviar plantillas de mensaje de WhatsApp, verás el error de abajo:
[ { "error_code": 141006, "error_description": "Hay un error con el método de pago.", "possible_solution": "Se produjo un error con tu método de pago. Añade un nuevo método de pago a la cuenta." } ]
Solo tienes que conectar una tarjeta de crédito válida a tus números WABA.
Deberás acceder al Meta Business Manager y encontrar la cuenta de WhatsApp.
Verificación de Salud
Si haces clic en Verificación de Salud, verás la captura de pantalla de abajo:
Esto te dará una visión general del estado de tu número de teléfono, del estado de la WABA y del estado de la cuenta de Meta Business.
Números de teléfono
Una cuenta comercial de WhatsApp (WABA) necesita un número de teléfono válido dedicado al uso de la Plataforma WhatsApp Business.
Esta guía presenta cómo elegir números de teléfono, añadirlos a tu cuenta y cuáles son las limitaciones de envío relacionadas.
Después de hacer clic en esta opción, serás redirigido a “Números de teléfono” en tu WhatsApp Manager, y el estado de tu número de teléfono se encuadrará en una de las categorías de abajo:
El estado se clasifica de la siguiente forma:
- Conectado : el remitente funciona normalmente.
- Señalado : este estado ocurre cuando la calificación de calidad del remitente alcanza un estado bajo (rojo). Durante ese estado, no es posible aumentar el nivel del límite de mensajes. Si la calificación de calidad mejora a un estado medio o alto en un plazo de 7 días desde el día en que el estado del remitente pasó a Señalado, el estado volverá a Conectado. Si la calificación de calidad no mejora, el estado del remitente volverá a Conectado, pero el límite de mensajes bajará al siguiente nivel inferior. El nivel más bajo para empresas verificadas es el Nivel 1.
- Restringido : este estado ocurre cuando el remitente alcanza el límite de mensajes. Durante la fase Restringido, no podrás enviar mensajes salientes (notificaciones) hasta que se reinicie la ventana de 24 horas. Solo podrás responder a los mensajes iniciados por los usuarios finales.
- Pendiente : puedes hacer clic en “Registrar números” para conectar tus números de teléfono.
Añadir 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 de la cantidad de WABA.
Si deseas añadir un nuevo número, hazlo a través del proceso de registro incorporado.
Cambiar el nombre para mostrar
Cada número de teléfono tiene su nombre para mostrar, y ese nombre debe estar relacionado con el nombre de tu empresa o marca. El nombre para mostrar será revisado por Meta. Puedes ir a Meta para cambiar el nombre.
Eliminar un número de teléfono de una WABA
Para la eliminación completa, sigue los pasos de abajo:
- En el Business Manager, ve a la página Configuración del Negocio.
- Ve a Configuración > Configuración del Negocio > Cuentas de WhatsApp > WhatsApp Manager > Números de teléfono.
- En WhatsApp Manager, encuentra el número de teléfono que deseas eliminar. Haz clic en el icono de papelera en Eliminar, en la esquina superior derecha.
Plantillas de mensajes
Este enlace te redirige a la sección de plantillas de WhatsApp en WhatsApp Manager. Puedes crear y enviar la plantilla directamente en WhatsApp Manager y, una vez aprobada, entrar en NicoChat para sincronizar la plantilla de vuelta en NicoChat.
También puedes hacer clic en el botón “Nueva plantilla” en NicoChat y luego crear y enviar la plantilla directamente dentro de NicoChat.
Catálogo
Las empresas pueden usar los Catálogos para compartir productos con los clientes mediante mensajes de producto único o de múltiples productos, o para mostrar sus productos y servicios a los clientes en la aplicación WhatsApp, permitiéndoles navegar y añadir artículos al carrito sin salir de la conversación, lo que proporciona una experiencia de compra continua y cómoda.
Si haces clic en el enlace “Catálogo”, serás redirigido a WhatsApp Manager. Haz clic en “Catálogo”, luego en “Elegir un catálogo” y, en el menú desplegable, selecciona el catálogo que deseas conectar.
Haz clic en “Ver catálogo” si deseas ver o gestionar el catálogo. Haz clic en “Conectar catálogo” y esos números WABA se conectarán al catálogo.
Si deseas sincronizar el catálogo de productos de Facebook con el comercio electrónico nativo de NicoChat, ve a “Integraciones”, luego a la categoría “Comercio electrónico”, haz clic en “Facebook Business” e inicia sesión en tu cuenta de Facebook.
Después de iniciar sesión en tu cuenta de Facebook, serás redirigido de vuelta al panel de NicoChat y deberás hacer clic en el botón “List Business Catalogs”.
Encuentra el catálogo vinculado a tus números WABA y haz clic en el botón “Facebook → Local”. A continuación, los productos de tu catálogo se sincronizarán con NicoChat Ecommerce → Productos.
Si abres cualquier producto sincronizado en NicoChat Ecommerce → Productos, verás que todos los títulos, descripciones, imágenes y precios del producto están sincronizados con los mensajes de Catálogo de Facebook.
Necesitarás el RetailID para enviar el mensaje de 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 nativa de compra de comercio electrónico en WhatsApp aquí .
¿Cuáles son los errores más comunes en el flujo de registro incorporado?
A. Errores de creación de la cuenta de Business Manager
Se produjo un error al procesar esta solicitud. Inténtalo de nuevo más tarde.
Este es un error poco claro, que requiere más asistencia. La creación de la cuenta comercial puede haber fallado por varios motivos.
==> Si recibes este error, usa una cuenta activa de Facebook o ponte en contacto con el soporte para resolverlo.
Has alcanzado el límite de empresas que puedes crear en este momento.
Hay un límite para 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 algún tiempo para crear una cuenta de Business Manager.
=> Usa una cuenta activa existente de Facebook o espera algunas horas antes de usar tu nueva cuenta. La nueva cuenta de Facebook puede usarse normalmente 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 contra el spam. Puedes intentarlo de nuevo más tarde.
Tu cuenta de Facebook fue señalada debido a un comportamiento sospechoso.
==> Necesitas usar una cuenta de Facebook activa y existente, sin problemas anteriores.
Ya no tienes permiso para usar los Productos de Facebook para anunciarte. No puedes publicar anuncios, gestionar activos publicitarios ni crear nuevos anuncios o cuentas comerciales.
No puedes crear nuevas cuentas de Business Manager debido a un comportamiento sospechoso anterior.
==> Usa una cuenta de Facebook activa y existente, sin problemas anteriores.
Tu cuenta de pago está desactivada
Tu cuenta de pago fue desactivada debido a un comportamiento sospechoso anterior.
==> Ponte en contacto con Facebook para obtener 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 determinado.
==> Usa una cuenta comercial existente para hacer la incorporación.
El nombre que elegiste para tu empresa no es válido. Considera usar xxx.
==> Añade un nombre válido que corresponda al nombre de tu empresa.
B. Errores de creación de la cuenta comercial de WhatsApp
El usuario no tiene permiso para crear cuentas de WhatsApp Business.
No tienes el permiso de administrador necesario para crear cuentas de WhatsApp en la cuenta comercial seleccionada.
==> Obtén acceso de administrador a la cuenta comercial para continuar o selecciona una cuenta en la que tengas permisos de administrador.
Solo puedes crear un número limitado de cuentas comerciales de WhatsApp antes de que se complete la verificación de tu empresa y de la cuenta de WhatsApp. Puedes crear cuentas adicionales después de ser verificado.
Intentaste crear varias cuentas comerciales de WhatsApp en una empresa no verificada.
==> Solo puedes crear cuentas comerciales adicionales de WhatsApp cuando se completen la verificación comercial y las comprobaciones de la cuenta de WhatsApp. Inicia la verificación comercial de la cuenta accediendo al Business Manager.
No podemos verificar la cuenta comercial de Facebook que seleccionaste. Vuelve a la pantalla anterior para seleccionar otra cuenta o accede a Facebook Business Manager para obtener soporte.
La cuenta comercial de Facebook seleccionada no cumple con nuestras políticas de uso de la API de WhatsApp Business y no pudo verificarse.
==> Accede a tu cuenta de Business Manager para obtener más información sobre esta cuenta comercial de Facebook. Si el envío de tu verificación comercial es rechazado, deberías haber recibido una notificación por correo electrónico con los motivos detallados. Puedes intentar reenviar tu verificación comercial si crees que hubo un error, o crear una cuenta comercial de WhatsApp usando una cuenta comercial de Facebook que ya haya sido verificada.
Algo salió mal. Deberás ponerte en contacto con el soporte e intentarlo de nuevo.
Este puede ser un problema intermitente de WhatsApp.
==> Puedes intentar el flujo de nuevo en unos minutos.
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 añadir un número de teléfono que ya existe en tu cuenta de WhatsApp Business.
==> Vuelve 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 e introduce el número nuevamente. Nota: puede tardar hasta 3 minutos para que el número quede disponible.
El número de teléfono ya estaba registrado en nuestra plataforma (es decir, WhatsApp Messenger, WhatsApp Business App o WhatsApp Business API).
==> Accede a la configuración de “WhatsApp Cloud” y cancela el registro del 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 en el perfil comercial del número de teléfono no cumple con nuestras directrices.
==> Consulta las directrices de Nombre para Mostrar e inténtalo de nuevo.
Algo salió mal. Deberás ponerte en contacto con el soporte e intentarlo de nuevo.
Hubo un problema al crear el perfil comercial del número de teléfono.
==> Introduce nuevamente el nombre correcto del Perfil de la Empresa de acuerdo con las directrices y los demás datos.
D. Errores de verificación del teléfono
La propiedad del número de teléfono ya fue verificada.
==> Este número de teléfono ya fue verificado. Puedes actualizar la página para ver el cambio aplicado.
Tu número de teléfono no parece ser válido. Compruébalo nuevamente o inténtalo de nuevo después de 5 minutos.
Se introdujo un número de teléfono incorrecto o no admitimos números en este formato.
==> Asegúrate de que el número esté operativo y verificado por un operador de telecomunicaciones. Por el momento, no admitimos números de respuesta de voz interactiva (IVR).
Has superado el número de intentos.
Para bloquear el spam, el sistema permite solo un número limitado de intentos de verificación.
==> Debes esperar unas 12 horas antes de intentarlo de nuevo. Después de ese período de espera, vuelve al flujo y selecciona cuentas y números de teléfono existentes para verificar nuevamente.
Se produjo 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 permite solo un número limitado de intentos de verificación.
==> Limitamos el número de veces que puedes solicitar un código dentro de un período determinado. Vuelve al flujo después del tiempo especificado y selecciona cuentas y números de teléfono existentes para solicitar un código nuevamente.