Tabla de contenido

WhatsApp Cloud API

JQ Lee Actualizado por JQ Lee

Ahora puede migrar su cuenta conectada de WhatsApp 360dialog a la API de WhatsApp Business de respond.io para disfrutar de una mayor confiabilidad, menores costos y acceso a nuevas funciones. Obtenga más información 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. Lea esta guía sobre cómo configurar su aplicación de Facebook.
Logotipo de WhatsApp

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

Este canal tiene una ventana de mensajería limitada de 24 horas debido a las regulaciones de WhatsApp. Conozca más sobre la política comercial de WhatsApp aquí.

Conexión de Cloud API de WhatsApp

Para chatear con sus clientes a través de Cloud API , conecte un perfil comercial de WhatsApp y una cuenta Meta Business.

Se requieren la aplicación de Facebook y una cuenta Meta Business y debes ser el administrador de ambas para conectarte.

Paso 1: Vaya a Configuración del espacio de trabajo > Haga clic en Agregar canal

Paso 2: Ubique el canal API de WhatsApp Cloud> Haga clic en Conectar.

Paso 3: haz clic en el botón Conectar con Facebook .

Paso 4: Inicie sesión con la cuenta de Facebook con acceso de administrador a la aplicación de Facebook y a la meta cuenta comercial.

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

Paso 6: Agregue la URL de devolución de llamada. Vuelva a la sección de WhatsApp en la aplicación para desarrolladores de Facebook. Navegue a la subsección Configuración y configure la URL de devolución de llamada. Agregue la URL de devolución de llamada generada y verifique el token de respond.io en los campos correspondientes en el cuadro de diálogo del webhook.

Sección de WhatsApp en la página de la aplicación para desarrolladores de Facebook
Agregar el cuadro de diálogo URL de devolución de llamada de webhook

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

Paso 8: Suscríbete al evento de webhook. En su aplicación de Facebook, seleccione la pestaña Webhooks en el panel Productos y seleccione Cuenta comercial de WhatsApp en la lista desplegable. Haga clic en el evento de suscripción de mensajes.

Suscríbete a la página del evento webhook

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

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

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

Una vez que hayas completado la configuración, todos los mensajes enviados a tu número de WhatsApp se recibirán en tu espacio de trabajo.

Configuración del canal

El canal Cloud API se puede configurar con un nombre de canal único.

Paso 1: Navegue hasta Configuración del espacio de trabajo > Haga clic en Canales.

Paso 2: Ubique el canal API de WhatsApp Cloud > Haga clic en Administrar.

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

Paso 4: Haga clic en Guardar cambios para actualizar la configuración del canal.

Metadatos recibidos por canal

Diferentes canales proporcionan diferentes conjuntos de metadatos de Contact a la plataforma respond.io . Aquí tienes la lista de datos de Contacto que podrás obtener de este canal:

  • Número de teléfono
  • Identificación del número de teléfono
  • Nombre de perfil
  • ID de whatsapp

Administrar el perfil Cloud API de WhatsApp

Si es necesario realizar un cambio o verificar su perfil API de WhatsApp Cloud, puede hacerlo en la plataforma respond.io.

Paso 1: Navegue hasta Configuración del espacio de trabajo > Haga clic en Canales.

Paso 2: Ubique el canal API de WhatsApp Cloud > Haga clic en Administrar > Perfil.

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

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

Campos

Descripción

Foto de perfil

Imagen que se muestra como foto de perfil de la cuenta empresarial de WhatsApp.

Se recomienda un tamaño de imagen de 640x640.

Acerca de

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

DIRECCIÓN

Dirección del negocio. Máximo de 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 la empresa. Máximo de 128 caracteres .

Vertical

Industria del negocio. Debe ser uno de estos valores aceptados:

  • Automotor
  • Belleza, Spa y Salón
  • Ropa y prendas de vestir
  • Educación
  • Entretenimiento
  • Planificación y servicio de eventos
  • Finanzas y Banca
  • Alimentos y abarrotes
  • Servicio público
  • Hotel y Alojamiento
  • Medicina y Salud
  • Sin ánimo de lucro
  • Servicios profesionales
  • Compras y venta al por menor
  • Viajes y transporte
  • Restaurante
  • Otro

La vertical empresarial no se puede restablecer a un valor vacío después de su creación.

Sitio web

URL (incluidos http:// o https:// ) asociadas con la empresa (por ejemplo, sitio web, página de Facebook, Instagram). Máximo 2 sitios web con un máximo de 256 caracteres cada uno.

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

Administrar plantillas de mensajes de WhatsApp

Antes de enviar una plantilla de mensaje a un contacto en la plataforma respond.io, asegúrese de haber hecho lo siguiente:
- Envió la plantilla de mensaje para su aprobación.
- Se agregó la plantilla de mensaje aprobada al espacio de trabajo sincronizando la plantilla de mensaje.

Envío de plantillas de mensajes

Paso 1: Navegue hasta Configuración del espacio de trabajo > Haga clic en Canales.

Paso 2: Ubique el canal API de WhatsApp Cloud > Haga clic en Administrar.

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

GIF de plantilla de envío de mensajes de API de WhatsApp Cloud

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

Campo

Descripción

Nombre de la plantilla

El nombre sólo puede contener caracteres alfanuméricos en minúscula 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 y luego revise el mensaje en la sección de vista previa. Puede incluir parámetros {{1}}, {{2}}, etc. como marcadores de posición para completar con contenido personalizado.

Bloque de construcción

Descripción

Cuerpo

El Cuerpo contiene el texto más importante de su plantilla. Sólo se admite texto.

Puede utilizar Markdown para formatear el contenido de este bloque. Aprende más aquí.

Encabezamiento

El encabezado es opcional y sirve como título o encabezado de su plantilla. Admite lo siguiente:

  • Texto
  • Imagen
  • Video
  • Documento

*La plataforma Respond.io acepta cargas de hasta 20 MB de tamaño.

Pie de página

El pie de página es opcional y solo admite texto. Se puede utilizar para proporcionar información complementaria en su plantilla de mensaje.

Botón

El Botón es opcional y añade interactividad a tus plantillas. Hay dos tipos disponibles:

  • Botón de llamada a la acción
    • Se utiliza para enviar a su cliente a un sitio web o llamar a un número de teléfono
    • Máximo una URL y un número de teléfono por plantilla
    • La URL puede tener un parámetro o personalización.
  • Botón de respuesta rápida
    • 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

* Los botones de respuesta rápida solo son compatibles con iOS, Android y plataformas web, pero no con la plataforma Windows. Consulte más detalles aquí.

Paso 6: proporcione un valor de muestra

Esto solo se aplica si ha incluido algún parámetro en el contenido de su plantilla de mensaje.

Proporcionar valores de muestra para el parámetro en la plantilla de mensaje ayudará al revisor de WhatsApp a comprender el mensaje que intenta enviar a sus contactos.

Sincronización de plantillas de mensajes

Paso 1: Navegue hasta Configuración del espacio de trabajo > Haga clic en Canales.

Paso 2: Ubique el canal WhatsApp Business Platform (API) > Haga clic en Administrar.

Paso 3: Haga clic en Plantillas > Sincronizar plantilla para comenzar el proceso de sincronización.

El proceso de sincronización ha sido completado. Esto significa:
- Se listarán las plantillas de mensajes con sus correspondientes estados.
- Se actualizará la fecha y hora de la última sincronización.
- Si su plantilla es rechazada, el motivo del rechazo se mostrará debajo de la plantilla del mensaje rechazado.

La siguiente tabla enumera los posibles estados de las plantillas de mensajes:

Estado

Descripción

Enviado

La plantilla de mensaje está enviada y pendiente de aprobación.

Aprobado

La plantilla de mensaje está aprobada y se puede enviar a los contactos.

Rechazado

La plantilla de mensaje se rechaza 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.

Límites de tarifas

Un límite de tasa es la cantidad de llamadas API que una aplicación o un usuario puede realizar dentro de un período de tiempo determinado definido por el canal. Conozca más sobre los límites de tarifas para este canal aquí .

Preguntas frecuentes y solución de problemas

No se pueden enviar mensajes

Asegúrate de que el número que has conectado a la plataforma sea un número Cloud API .

Los mensajes no llegan

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

Paso 1: navegue a la página del webhook de la aplicación de Facebook

Abra la aplicación de Facebook y navegue hasta la página de Webhooks.

Paso 2: Verificar el evento suscrito

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

Webhook de mensajes de suscripción de API de WhatsApp Cloud

Paso 3: envía un mensaje de prueba

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

No se pueden recibir recibos de lectura

Cuando el usuario conectado a Cloud API cambia su contraseña de Facebook, los permisos quedarán obsoletos y deberán actualizarse.

Paso 1: navegue hasta Configuración del espacio de trabajo > Haga clic en Canales.

Paso 2: Ubique el canal WhatsApp Business Platform (API) > Haga clic en Administrar.

Paso 3: haga clic en Solucionar problemas > Actualizar permiso para actualizar los permisos de WhatsApp.

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

No se pueden enviar mensajes salientes: error al validar el token de acceso

Esto puede suceder por varias razones:

  • Cuando la sesión de validación del token de acceso haya caducado.
  • Hubo un cambio en el privilegio de administrador del usuario en Meta Business Manager.
  • Hubo un cambio de contraseña en Meta Business Manager.
captura de pantalla que muestra el error de la API de WhatsApp Cloud

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

Debe ser el administrador de Meta Business Manager para poder actualizar el permiso.

Contacto que no recibe mensajes

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

Si sus contactos no pueden recibir mensajes desde su número Cloud API , asegúrese de que hayan aceptado los términos y la política de privacidad más recientes de WhatsApp.

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

  • El número de teléfono utilizado para Cloud API no se puede utilizar en la aplicación personal o empresarial de WhatsApp. Tendrás que eliminar la cuenta en la aplicación personal o empresarial de WhatsApp antes de poder usar el número para registrarte en una Cloud API.
  • Aún puedes usar el número para otros fines, como llamar y recibir SMS después de registrarlo en WhatsApp Business Platform.
  • Una vez que use un teléfono para Cloud API , ya no podrá usar ese número en la aplicación WhatsApp Business.

¿Se necesita verificación empresarial para comenzar a utilizar Cloud API ?

No es obligatorio completar la verificación comercial de Facebook para comenzar a enviar mensajes en WhatsApp. Sin la verificación comercial, su empresa aún podrá:

  • Responda a conversaciones ilimitadas iniciadas por usuarios.
  • Envíe conversaciones iniciadas por empresas (plantillas de mensajes) a 250 clientes únicos en un período continuo de 24 horas.
  • Registre hasta 2 números de teléfono.

Las empresas pueden iniciar la verificación comercial solo cuando estén listas para escalar las conversaciones iniciadas por empresas o quieran convertirse en una cuenta comercial oficial.

¿Puedo ver las estadísticas de mis conversaciones para mi cuenta empresarial de WhatsApp?

Sí, puede monitorear sus mensajes y análisis de gastos en tiempo real para su cuenta comercial de WhatsApp en la pestaña Insights de su Meta WhatsApp Manager. Lea más aquí.

¿Cuáles son los límites de mensajería de WhatsApp?

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

¿Cómo agrego un método de pago a mi cuenta de WhatsApp Business?

Puede agregar un método de pago a su cuenta de Whatsapp Business en Business Manager. Aprenda cómo agregar un método de pago a su cuenta WhatsApp Business aquí.

¿Por qué mi mensaje no se envió con el error "Problema de pago de elegibilidad empresarial"?

Lo más probable es que esto se deba a que excediste el umbral del nivel gratuito mensual sin un método de pago válido. Para resolver este problema, agregue un método de pago válido.

¿Cuál es el precio Cloud API ?

Las conversaciones de WhatsApp Business Platform se dividen en dos categorías que tienen precios diferentes:

  • Iniciada por el usuario: una conversación que se inicia en respuesta a un mensaje de usuario. Siempre que una empresa responda a un usuario dentro del período de servicio al cliente de 24 horas, ese mensaje se asociará con una conversación iniciada por el usuario. Las empresas pueden enviar mensajes de formato libre dentro de este período de servicio al cliente de 24 horas.
  • Iniciada por la empresa: una conversación que se inicia desde una empresa que envía un mensaje a un usuario fuera del período de servicio al cliente de 24 horas. Los mensajes que inician una conversación iniciada por una empresa requerirán una plantilla de mensaje.

Todas las conversaciones se miden en sesiones fijas de 24 horas. Una conversación comienza cuando se entrega el primer mensaje comercial de una conversación, ya sea iniciado por la empresa o en respuesta a un mensaje de usuario. Las empresas y los usuarios pueden intercambiar cualquier cantidad de mensajes, incluidos mensajes de plantilla, dentro de una sesión de conversación de 24 horas sin incurrir en cargos adicionales. Cada sesión de conversación de 24 horas supone un único cargo.

Los cargos por las conversaciones se basan en el código de país del usuario. Un usuario aquí se define como el cliente con el que se comunica su empresa. Las tarifas para conversaciones iniciadas por empresas y por usuarios varían según el país o la región. Lea más aquí.

A partir del 1 de junio de 2023, habrá cambios en los precios basados en conversaciones para WhatsApp. Obtenga más información sobre estas nuevas categorías de conversación y cambios de precios 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 transmisión de la API de WhatsApp Cloud con el número de metaprueba?

Puede enviar una transmisión de prueba desde la plataforma utilizando el número de metaprueba. Sin embargo, una transmisión que utilice 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 Developer.

Agregar números de destinatarios de prueba en Meta Developer Tools

Si no agrega destinatarios a esta lista o si intenta enviar una transmisión a destinatarios que no están en esta lista, recibirá este mensaje de error:

mensaje de error para la transmisión de prueba de la API de WhatsApp Cloud

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

No, este número se proporciona automáticamente a todas las cuentas para enviar mensajes de prueba y no se puede eliminar. Sólo tenga cuidado de tener en cuenta que este es un número de prueba que no debe usarse para otros fines.

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

WhatsApp pasa el número de teléfono del contacto en un formato diferente al formato E.164 que utiliza respond.io. Esta diferencia hace que se dupliquen los contactos de ciertos países. Si esto ocurre, comuníquese con nosotros aquí.

¿Sentirse atrapado? No temas.

¿Necesitas ayuda? Contáctanos para recibir asistencia. ¡La ayuda está aquí!

Desactivar la verificación en dos pasos del número de WhatsApp

360diálogo WhatsApp

Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)