respond-io
New
🚀 ¡Mensajería de negocios de TikTok está en vivo! Convierte las conversaciones en conversiones sin problemas. Conoce másarrow-icon

Inicio >

Canales >
WhatsApp >
API de WhatsApp Cloud

API de WhatsApp Cloud

Avatar
JQ Lee
· 23 Jul 2024
9 min de lectura

Ahora puede migrar su cuenta de diálogo de WhatsApp 360o conectada a respond.io WhatsApp Business API para disfrutar de una mayor fiabilidad, menores costos y acceso a nuevas características. Aprende más sobre el proceso de migración aquí.

Para conectar la API de WhatsApp Cloud, se requiere una aplicación de Facebook con el producto WhatsApp habilitado. Lee esta guía sobre cómo configurar tu aplicación de Facebook.

Facebook anunció el lanzamiento de la API de WhatsApp Cloud el 20 de mayo, y está disponible para cualquier negocio de cualquier tamaño, grande y pequeña para comunicarse con clientes usando la API oficial de WhatsApp.

Este canal tiene una ventana limitada de mensajería 24 horas debido a las regulaciones de WhatsApp. Obtenga más información sobre la política empresarial de WhatsApp's aquí.

Conectando la API de WhatsApp Cloud

Mira el vídeo de abajo para una guía paso a paso sobre Cómo conectar la API de WhatsApp Cloud a respond.io.

Para chatear con tus clientes a través de la API de WhatsApp Cloud, conecta un perfil de negocios de WhatsApp y una cuenta de negocio meta.

La aplicación de Facebook y la cuenta Meta Business son necesarios y usted debe ser el administrador de ambos para conectarse.

Paso 1:Navegue aConfiguración del espacio de trabajo> Haga clic enAñadir canal

Paso 2:Ubica el canal API de WhatsApp Cloud > Haz clic enConectar.

Paso 3: Haga clic en el botónConectar con Facebook.

Paso 4: Iniciar sesión usando la cuenta de Facebook con acceso de administrador a la aplicación de Facebook y a la cuenta de negocios Meta.

Paso 5: En la lista desplegable, seleccione el nombre WABA con el número de WhatsApp al que desea conectarse.

Paso 6: Añadir la URL de devolución de llamadas. Volver a la secciónWhatsAppen la aplicación de desarrolladores de Facebook. Vaya a la subsecciónConfiguracióny configure la URL de devolución de llamadas. Añada la URL generada de Callback y verifique el token de respond.io a los campos correspondientes en el diálogo de webhook.

Paso 7: En la aplicación de Facebook, verifique y guarde los cambios en la aplicación.

Paso 8: Suscribirse al evento webhook. En tu aplicación de Facebook, selecciona la pestañaWebhooksen el panelProductsy seleccionaWhatsApp Business Accounten la lista desplegable. Haga clic en el evento de mensajes de suscripción.

Paso 9: Haga clic en el interruptor en la parte superior de la página para activar el modo en vivo.

Recuerde llenar la URL de su política de privacidad. Si esto está en blanco, no se le permitirá activar el modo en vivo.

Paso 10: Haga clic en Guardar Cambios para completar la configuración.

Una vez que hayas completado la configuración, cualquier mensaje enviado a tu número de WhatsApp ahora se recibirá en tu Espacio de trabajo.

Configuración del canal

El canal API de WhatsApp Cloud puede configurarse con un nombre único del Canal.

Paso 1:Navegue aConfiguración del espacio de trabajo> Haga clic enCanales.

Paso 2:Ubica el canal API de WhatsApp Cloud > Haz clic enAdministrar.

Paso 3:Configure el nombre del canal, que se utiliza internamente para identificar la cuenta.

Paso 4:Haga clic enGuardar Cambios para actualizar la configuración del canal.

Metadatos recibidos por canal

Diferentes canales proporcionan diferentes conjuntos de metadatos de Contacto a la plataforma respond.io. Esta es la lista de datos de contacto que podrás obtener de este canal:

  • Número de teléfono

  • ID de número de teléfono

  • Nombre de perfil

  • ID de Whatsapp

Administrar perfil API de WhatsApp Cloud

Si hay necesidad de hacer un cambio o comprobar su perfil API de WhatsApp Cloud, se puede hacer en la plataforma respond.io.

Paso 1:Navegue aConfiguración del espacio de trabajo> Haga clic enCanales.

Paso 2:Ubica el canal API de WhatsApp Cloud > Haz clic enAdministrar > Perfil.

Paso 3: Haga clic en Sincronizar perfil para obtener la información más reciente del perfil de WhatsApp Business de WhatsApp.

Paso 4: Edite la siguiente información según sea necesario.

Campos

Descripción

Foto de perfil

Imagen mostrada como la imagen de perfil de la cuenta de negocios de WhatsApp. Se recomienda un tamaño de imagen de 640x640.

Quiénes somos

El negocio's Acerca del texto. Este texto aparece en el perfil de la empresa'bajo su imagen de perfil, número de teléfono y botones de contacto.

Dirección

Dirección del negocio. Máximo 256 caracteres.

Descripción

Descripción del negocio. Máximo de 512 caracteres.

Correo electrónico

Dirección de correo electrónico (en formato de correo electrónico válido) para contactar con el negocio. Máximo 128 caracteres.

Vertical

Industria del negocio. Debe ser uno de estos valores aceptados: AutomotiveBeauty, Spa y SalonClothing and ApparelEducationEntertainmentEvent Planning and ServiceFinance and BankingFood and GroceryPublic ServiceHotel and LodgingMedical and HealthNon-profitProfessional ServicesShopping and RetailTravel and TransportationRestaurantOtro.

Sitio web

URLs (incluyendo http:// o https://) asociados con el negocio (por ejemplo, sitio web, página de Facebook, Instagram). Máximo de 2 sitios web con un máximo de 256 caracteres cada uno.

Paso 5: Revise la información y haga clic en Guardar cambios.

Gestionar plantillas de mensajes de WhatsApp

Antes de enviar una plantilla de mensaje a un Contacto en la plataforma respond.io, asegúrate de haber hecho lo siguiente:

- Se ha enviado la plantilla de mensaje para su aprobación - Se ha añadido la plantilla de mensaje aprobada al espacio de trabajo sincronizando la plantilla de mensaje

Envío de plantillas de mensajes

Paso 1:Navegue aConfiguración del espacio de trabajo> Haga clic enCanales.

Paso 2:Ubica el canal API de WhatsApp Cloud > Haz clic enAdministrar.

Paso 3: Haga clic en Plantillas > Enviar plantilla para enviar una plantilla de mensaje para su aprobación.

Paso 4: Complete la información requerida necesaria para crear una plantilla.

Campo

Descripción

Nombre de plantilla

El nombre sólo puede contener caracteres alfanuméricos en minúsculas y guiones bajos ( _ )

Categoría

La categoría a la que pertenece la plantilla de mensaje.

Idioma

El idioma en el que está escrita la plantilla.

Paso 5: Cree el mensaje completando los componentes necesarios, luego revise el mensaje en la sección de vista previa. Puede incluir los parámetros 1, 2, etc. como marcadores de posición para ser rellenados con contenido personalizado.

Bloque de construcción

Descripción

Cuerpo

El cuerpo contiene el texto más importante de su plantilla. Sólo el texto es compatible. Puedes usar markdown para formatear el contenido de este bloque. Aprende más aquí.

Cabecera

El Encabezado es opcional y sirve como el título o la cabecera de su plantilla. Soporta lo siguiente:
- Texto
- Imagen
- Video
- Documento

* Responde. o plataforma acepta subir hasta 20MB de tamaño.

Pie de página

El pie de página es opcional y sólo admite texto. Puede utilizarse para proporcionar información adicional en su plantilla de mensajes.

Botón

El botón es opcional y añade interactividad a sus plantillas. Hay dos tipos disponibles:
Llamar al botón de acción
- Se utiliza para enviar a su cliente a un sitio web o llamar a un número de teléfono
- Máximo un URL y número de teléfono por plantilla
- La URL puede tener un parámetro o personalización rápida

El botón de respuesta
- Se utiliza para obtener respuestas rápidas de su cliente
- Máximo 3 botones de respuesta rápida por plantilla
- Cada botón de respuesta rápida no puede tener más de 20 caracteres

* Botones de respuesta rápida sólo son compatibles en iOS, Plataformas Android y web, pero no en plataformas Windows. Consulte más detalles aquí.

Paso 6: Proporcionar valor de muestra

Esto sólo es aplicable si ha incluido algún parámetro en el contenido de su plantilla de mensajes.

Proporcionar valores de ejemplo al parámetro en la plantilla de mensaje ayudará al revisor de WhatsApp a entender el mensaje que estás intentando enviar a tus contactos.

Enlace importante: directrices de plantilla de mensaje de WhatsApp

Sincronizando plantillas de mensajes

Paso 1:Navegue aConfiguración del espacio de trabajo> Haga clic enCanales.

Paso 2:Ubica el canal de la Plataforma WhatsApp Business (API) > Haz clic enAdministrar.

Paso 3: Haga clic en plantillas > Sincronizar Plantilla para iniciar el proceso de sincronización.

El proceso de sincronización se ha completado. Esto significa:

- Las plantillas de mensaje se mostrarán con sus estados correspondientes.- La última fecha de sincronización se actualizará. Si su plantilla es rechazada, el motivo de rechazo se mostrará debajo de la plantilla de mensaje rechazada.

La siguiente tabla muestra los estados posibles para las plantillas de mensajes:

Estado

Descripción

Enviada

La plantilla de mensaje se envía y está pendiente de aprobación.

Aprobada

La plantilla de mensaje es aprobada y puede ser enviada a contactos.

Rechazada

La plantilla de mensaje ha sido rechazada y no se puede utilizar.

Utilice la búsqueda y el filtro en la esquina superior derecha del listado para encontrar fácilmente sus plantillas!

Tipos de archivo soportados

El tipo de archivo soportado por WhatsApp y el tamaño máximo para el tipo es el siguiente:

  • Audio & Video (16MB)

  • Documento (100 MB)

  • Imagen (5 MB)

  • Pegatina (100 KB)

Los mensajes que no estén soportados tendrán una pantalla de retroceso con mensaje no soportado o texto y tipo de carga personalizada (si está disponible). Para cualquier tipo de archivo o archivo que exceda el tamaño máximo enviado mediante la API de WhatsApp Cloud, el archivo se convertirá automáticamente en un enlace URL en la respuesta. o plataforma. Para Payload personalizado, puede hacer clic en Mostrar máspara ver la carga útil JSON de este mensaje. Ejemplos de mensajes no admitidos para la API de WhatsApp Cloud son:
- Tarjeta de contacto
- Reacciones
- Mensaje eliminado
- Encuestas
- Mensaje Efemeral

Límites de tasa

Un límite de tarifa es el número de llamadas API que un usuario o aplicación puede hacer dentro de un período de tiempo determinado definido por el canal. Obtenga más información sobre los límites de velocidad para este canal aquí.

Preguntas frecuentes y solución de problemas

No se puede enviar mensajes

Asegúrate de que el número que has conectado a la plataforma es un número de API de la nube de WhatsApp.

Los mensajes no están entrando

Esto puede ocurrir cuando el webhook de mensajes no está suscrito.

Paso 1: Navega a la página web de la aplicación de Facebook

Abre la aplicación de Facebook y navega a la página Webhooks.

Paso 2: Verifique el evento suscrito

Seleccione Cuenta de WhatsApp Business y verifique si el evento mensajes está suscrito.

Paso 3: Enviar un mensaje de prueba

Envía un mensaje de prueba al número de teléfono de WhatsApp y comprueba si ha llegado.

No se pueden recibir recibos de lectura

Cuando el usuario conectado a la API de WhatsApp Cloud cambia su contraseña de Facebook, los permisos serán desactualizados y necesitan ser actualizados.

Paso 1:Navegue aConfiguración del espacio de trabajo> Haga clic enCanales.

Paso 2:Ubica el canal de la Plataforma WhatsApp Business (API) > Haz clic enAdministrar.

Paso 3: Haz clic en Resolución de problemas >Actualizar Permisopara actualizar los permisos de WhatsApp.

Paso 4: Envía un mensaje de prueba al número de teléfono de WhatsApp y verifica si llegó.

No se puede enviar mensajes salientes: Validando error de token de acceso

Esto puede suceder por varias razones:

  • Cuando la sesión para validar el token de acceso ha caducado.

  • Hubo un cambio en el privilegio de administrador de usuario's en Meta Business Manager.

  • Hubo un cambio de contraseña en Meta Business Manager.

Para solucionar este error, debes actualizar los permisos del canal de WhatsApp Cloud API y enviar un mensaje de prueba nuevamente.

Debes ser el administrador del Meta Business Manager para poder actualizar el permiso.

Contacto no recibido mensajes

Esto puede suceder cuando el contacto no ha aceptado los términos y la política de privacidad de WhatsApp.

Si tus Contactos no pueden recibir mensajes de tu número API de WhatsApp Cloud, asegúrese de que han aceptado las últimas condiciones y política de privacidad de WhatsApp.

¿Cuáles son los requisitos para utilizar el número de teléfono para registrarse en la API de WhatsApp Cloud?

  • El número de teléfono utilizado para la API de WhatsApp Cloud puede'no ser utilizado en la aplicación personal o empresarial de WhatsApp. 'Tendrás que eliminar la cuenta en la aplicación personal o comercial de WhatsApp antes de poder usar el número para registrarte en una API de WhatsApp Cloud.

  • Aún puede utilizar el número para otros fines, como llamar y recibir SMS después de registrarlo en la plataforma empresarial de WhatsApp.

  • Una vez que utilices un teléfono para la API de WhatsApp Cloud, ya no puedes usar ese número en la aplicación empresarial de WhatsApp.

¿Es necesaria la verificación empresarial para empezar a usar la API de la nube?

No es obligatorio completar la verificación empresarial de Facebook para empezar a enviar mensajes en WhatsApp. Sin la verificación del negocio, su negocio podrá seguir haciendo:

  • Respuesta a conversaciones ilimitadas iniciadas por el usuario.

  • Envía conversaciones iniciadas por empresas (plantillas de mensajes) a 250 clientes únicos en un período de 24 horas.

  • Registrar hasta 2 números de teléfono.

Las empresas solo pueden iniciar la verificación empresarial cuando'vuelvan listos para escalar conversaciones iniciadas por empresas o quieran convertirse en una cuenta empresarial oficial.

¿Puedo ver mis opiniones de conversación para mi cuenta de negocios de WhatsApp?

Sí, puedes supervisar tu mensajería y análisis de gastos en tiempo real para tu cuenta de negocios de WhatsApp en la pestaña Insights de tu administrador de Meta WhatsApp. Lea más aquí.

¿Qué son los límites de mensajería de WhatsApp?

Los límites de mensajería determinan el número máximo de conversaciones iniciadas por los negocios que cada número de teléfono puede enviar en un período de 24 horas. Estos límites no se aplican a las conversaciones iniciadas por el usuario. Una conversación iniciada por el negocio comienza cuando el primer mensaje se entrega a un cliente y termina 24 horas después. Lea más aquí.

¿Cómo puedo añadir un método de pago a mi cuenta comercial de WhatsApp?

Puede añadir un método de pago a su cuenta de WhatsApp Business en Business Manager. Aprende añadir un método de pago a tu cuenta de WhatsApp Business aquí.

¿Por qué mi mensaje falló al enviar con un error "Business eligibility payment issue"?

Esto se debe muy probablemente a que usted supere el umbral mensual gratuito sin un método de pago válido. Para resolver este problema, agregue un método de pago válido.

¿Qué es el precio de WhatsApp Cloud API?

La API de WhatsApp utiliza un modelo de precios basado en conversaciones que cobra a las empresas por el número de conversaciones que tienen. Una conversación comienza cuando tu mensaje de negocio' se entrega a un cliente y dura 24 horas ventana de servicio al cliente, durante el cual cualquier número de mensajes pueden ser intercambiados entre el cliente y el negocio. Las empresas tienen cargos por cada conversación individual, independientemente de cuántos mensajes se envían o reciben dentro de esa ventana de servicio al cliente.

Obtenga más información sobre los precios de WhatsApp aquí.

¿Cómo elimino un número de teléfono de una cuenta comercial?

Hay algunos requisitos y pasos necesarios para eliminar un número de teléfono, lea más aquí.

¿Puedo usar respond.io para enviar una emisión de la API de WhatsApp Cloud con el número de prueba Meta?

Puede enviar una emisión de prueba desde la plataforma utilizando el número de prueba Meta. Sin embargo, una emisión utilizando el número de prueba está limitada a cinco destinatarios. Primero debe agregar estos cinco destinatarios a la lista de números de teléfono en las herramientas de Meta-Desarrollador.

Si no añade destinatarios a esta lista o si intenta enviar una emisión a destinatarios que no estén en esta lista, recibirás este mensaje de error:

¿Puedo eliminar el número de Meta prueba de mi cuenta de Cloud API conectada?

No, este número se proporciona automáticamente a todas las cuentas a utilizar para enviar mensajes de prueba y no se puede eliminar. Tenga en cuenta que se trata de un número de prueba que no debe utilizarse para otros fines.

¿Por qué veo contactos duplicados del mismo canal WhatsApp?

WhatsApp pasa el número de teléfono del contacto en un formato diferente del formato E.164 que respond.io utiliza. Esta diferencia hace que los Contactos de ciertos países sean duplicados. Si esto ocurre, contáctenos aquí.

¿Cómo cambio el nombre de la API de la nube?

Para cambiar el nombre para mostrar de tu API de Cloud, sigue estos pasos:

  1. Vaya a su FBM > Cuenta WhatsApp > Número de teléfono. Esta página muestra su límite de mensajería y calidad.

  2. Mueva el icono del lápiz junto al nombre de la pantalla para activar la edición.

  3. Haga clic en Siguiente para enviar su nuevo nombre a Meta para su aprobación.

  4. Espere la confirmación de la aprobación de Meta.

¿Qué pasos debo dar una vez que mi nuevo nombre de pantalla para mi API de la nube sea aprobado?

Después de recibir la aprobación de Meta para su nuevo nombre de visualización, complete los siguientes pasos:

  1. Vuelva a registrar su número de teléfono utilizando el nombre de la pantalla recién aprobado.

  2. Ejecute una llamada POST API a verifique su número de teléfono.

  3. Hacer otra llamada POST API a volver a registrar el número de teléfono verificado.

  4. Una vez realizado con éxito, la actualización del nombre de tu API de la nube's está completa.

¿Por qué encontré el error "Error validando el token de acceso: La sesión ha sido invalidada porque el usuario cambió su contraseña o Facebook ha cambiado la sesión por razones de seguridad" cuando intentaba enviar un mensaje?

Este error se producirá si has actualizado recientemente tus credenciales de Facebook, puede interrumpir la conexión del Canal en nuestra plataforma, provocando errores al enviar mensajes.

Para resolver este problema, necesita actualizar los permisos de canal en nuestra plataforma usando sus credenciales de Facebook actualizadas. Este proceso requiere un rol de Administrador. Al actualizar los permisos,'volverá a establecer la conexión con las nuevas credenciales, asegurando que sus mensajes salientes se envían con éxito sin encontrar errores.

Compartir este artículo
Telegram
Facebook
Linkedin
Twitter

Artículos relacionados 👩‍💻

Plataforma de negocios de WhatsApp (API) Inicio rápido
Obtén una cuenta de WhatsApp Business API rápida para empezar a chatear con tus clientes.
API de llamadas empresariales de WhatsApp.
Aprende cómo usar la API de llamadas empresariales de WhatsApp para recibir y hacer llamadas.
Migración del número de teléfono a respond.io WhatsApp Business Platform (API)
Aprenda cómo migrar su número de teléfono de otros BSSales a respond.io WhatsApp Business API.
Obteniendo Listo para Conversaciones Entrantes
Aprenda sobre las ventanas de conversación, envíe plantillas de mensajes y configure un punto de entrada simple para administrar los mensajes de WhatsApp de sus clientes.
Plantillas de mensajes de WhatsApp
Utilice las plantillas de mensajes de WhatsApp para comprometerse con los contactos en cualquier momento.

¿No encuentras lo que buscas? 🔎