Primeros pasos para socios de soluciones

En esta guía, se revisan los pasos que los socios de soluciones deben seguir para ofrecer la API de la nube a sus clientes. Hay cuatro etapas principales:

1. Preparar y planificar
2. Configurar activos
3. Firmar contratos
4. Generar integración

Cuando termines, mantente al día con las actualizaciones mensuales.

Preparar y planificar

Lee la documentación

Antes de empezar, te recomendamos que leas toda nuestra documentación para desarrolladores y nuestra colección de Postman. De esta manera, comprenderás cómo funciona la API de la nube y sabrás cómo empezar a migrar números.

Planifica el registro y la migración

Debes usar el registro insertado para registrar nuevos clientes en la API de la nube. Si todavía no lo hiciste, integra y lanza el registro insertado, que es la manera más rápida y sencilla de registrar clientes, y les permite empezar a enviar mensajes en menos de cinco minutos.

Luego, piensa en qué clientes quieres migrar primero a la API de la nube. En general, recomendamos migrar todos los clientes de la API de instalaciones locales a la API de la nube, pero las necesidades de cada uno pueden variar. Mientras piensas en qué clientes vas a migrar, considera lo siguiente:

Una vez que sepas a qué clientes vas a migrar, puedes construir un plan y un cronograma de migración.

Cuando crees tu plan, recuerda diseñar el sistema para dos situaciones: registro de nuevos clientes y migración de clientes actuales de la API de instalaciones locales a la API de la nube. Para la migración, incluye planes para realizar copias de seguridad de la instancia actual de instalaciones locales y migra esos números a la API de la nube.

Planifica la comunicación con los clientes

En primer lugar, debes decidir si vas a notificar a los clientes actuales sobre la migración. Luego, deberías determinar si necesitas crear o actualizar algún tipo de documentación para permitir la configuración de la API de la nube.

Toma decisiones relacionadas con los precios

Debido a que los costos de alojamiento de la API de la nube están a cargo de Meta, deberías decidir si quieres actualizar tus precios de forma correspondiente.

Configurar activos

Para usar la API de la nube, los socios de soluciones deben tener los siguientes activos:

Firmar contratos

Aceptación de las Condiciones del servicio

Para acceder a la API Cloud de mensajes de WhatsApp Business, primero debes aceptar las Condiciones del servicio de la Plataforma de WhatsApp Business en nombre de la empresa.

Para hacerlo, ve al Administrador de WhatsApp y acepta las Condiciones del servicio en el banner de información.

Si ya eres socio de la versión beta de la API Cloud, tienes un período de gracia de 90 días. Esto significa que debes aceptar las Condiciones antes del 5 de julio de 2022 o perderás acceso.

Las empresas nuevas en API Cloud, incluidas las que migran desde la API en las instalaciones locales, deben aceptar las Condiciones del servicio antes de poder comenzar a usar la API Cloud. Las llamadas de registro se rechazarán hasta que no aceptes las Condiciones del servicio.

Generar integración

Paso 1: Obtén el token de acceso de usuario del sistema

Las llamadas de la API Graph utilizan los tokens de acceso para la autenticación. Para obtener más información, consulta Tokens de acceso. Te recomendamos usar tu usuario de sistema para generar el token.

Para generar un token de acceso de usuario del sistema:

1. Ve a Administrador comercial > Configuración del negocio > Usuarios > Usuarios del sistema para ver el usuario del sistema que creaste.
2. Haz clic en dicho usuario y selecciona Agregar activos. Se abrirá una nueva ventana.
3. En Seleccionar tipo de activo del panel lateral de la izquierda, selecciona Apps. En Seleccionar activos, selecciona la app de Meta que quieres usar (la app debe tener los permisos adecuados). Activa Desarrollar app para dicha app.
4. Selecciona Guardar cambios para guardar la configuración y volver a la pantalla principal del usuario del sistema.
5. Ya puedes generar el token. En la pantalla principal del usuario del sistema, haz clic en Generar token y selecciona tu app de Meta. Una vez que selecciones la app, verás una lista de permisos disponibles. Selecciona whatsapp_business_management y whatsapp_business_messaging. Haz clic en Generar token.
6. Se abre una nueva ventana con tu usuario de sistema, la app asignada y el token de acceso. Guarda el token.
7. De manera opcional, puedes hacer clic en el token y ver el depurador de token. En el depurador, debes ver los dos permisos que seleccionaste. También puedes pegar directamente el token en el depurador de token de acceso.

Paso 2: Configura los webhooks

Con los webhooks configurados, puedes recibir notificaciones HTTP en tiempo real desde la Plataforma de WhatsApp Business. Esto significa que recibes una notificación cuando, por ejemplo, se te envía un mensaje de un cliente o se realizan cambios en tu cuenta de WhatsApp Business (WABA).

Para configurar el webhook, debes crear un servidor web orientado a Internet con una URL que cumpla con los requisitos de Meta y WhatsApp. Consulta Creación de un punto de conexión para obtener instrucciones sobre cómo hacerlo. Si necesitas un punto de conexión con fines de prueba, puedes generar un punto de conexión de webhooks de prueba.

Configuración de la app

Una vez que el punto de conexión esté listo, configúralo para que lo use tu app de Meta:

Solo debes configurar webhooks una vez para cada aplicación que tengas. Puedes usar el mismo webhook para recibir varios tipos de eventos de varias cuentas de WhatsApp Business. Para obtener más información, consulta la sección sobre webhooks.

Paso 3: Suscríbete a tu cuenta de WhatsApp Business

Para asegurarte de recibir notificaciones de la cuenta correcta, suscribe tu app:

curl -X POST \
'https://graph.facebook.com/v19.0/WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps' \
-H 'Authorization: Bearer ACCESS_TOKEN'

Si obtienes la siguiente respuesta, todos los eventos de webhook para los números de teléfono de esta cuenta se enviarán al punto de conexión de webhooks que hayas configurado.

{
  "success": true
}

Paso 4: Obtén el identificador del número de teléfono

Para enviar mensajes, debes registrar el número de teléfono que quieras usar, que es el número de teléfono de empresa que se especificó en Antes de empezar.

Antes de continuar con el registro, debes obtener el identificador del número de teléfono. Para eso, haz la siguiente llamada a la API:

curl -X GET \
'https://graph.facebook.com/v19.0/WHATSAPP_BUSINESS_ACCOUNT_ID/phone_numbers' \
-H 'Authorization: Bearer ACCESS_TOKEN'

Si la solicitud se realiza correctamente, la respuesta incluye todos los números de teléfono conectados a tu cuenta de WhatsApp Business:

{
  "data": [
    {
      "verified_name": "Jasper's Market",
      "display_phone_number": "+1 631-555-5555",
      "id": "1906385232743451",
      "quality_rating": "GREEN"
    },
    {
      "verified_name": "Jasper's Ice Cream",
      "display_phone_number": "+1 631-555-5556",
      "id": "1913623884432103",
      "quality_rating": "NA"
    }
  ]
}

Guarda el identificador del número de teléfono que quieras registrar. Consulta Leer números de teléfono para obtener más información sobre este punto de conexión.

Excepción de migración

Paso 5: Registra el número de teléfono

Una vez que tengas el identificador del número de teléfono, puedes registrarlo. En la llamada a la API de registro, realizas dos acciones al mismo tiempo:

1. Registras el teléfono.
2. Activas la verificación en dos pasos mediante la configuración de un código de registro de seis dígitos. Debes configurar el código de tu lado. Guarda y memoriza el código, ya que es posible que se solicite más adelante.

Para usar la API de la nube, se debe configurar la autenticación en dos pasos. Si no la configuras, recibirás un mensaje de error de integración:

Ejemplo de solicitud:

curl -X POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/register' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"messaging_product": "whatsapp","pin": "6_DIGIT_PIN"}'

Ejemplo de respuesta:

{
  "success": true
}

Usuarios del registro insertado

Paso 6: Recibe un mensaje de la app para consumidores

Una vez que los clientes participantes envían un mensaje a tu empresa, obtienes 24 horas de mensajes gratuitos con ellos; este período se denomina "intervalo de servicio de atención al cliente". Para fines de prueba, debes activar este intervalo si quieres enviar tantos mensajes como sea posible.

Desde una app personal de WhatsApp para iOS o Android, envía un mensaje al número de teléfono que acabas de registrar. Después de enviar el mensaje, debes recibir un mensaje entrante en tu Webhook con una notificación con el formato siguiente.

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "16315551234",
              "phone_number_id": "PHONE_NUMBER_ID"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Kerry Fisher"
                },
                "wa_id": "16315555555"
              }
            ],
            "messages": [
              {
                "from": "16315555555",
                "id": "wamid.ABGGFlA5FpafAgo6tHcNmNjXmuSf",
                "timestamp": "1602139392",
                "text": {
                  "body": "Hello!"
                },
                "type": "text"
                }
            ]
          },
        "field": "messages"
        }
      ]
    }
  ]
}

Paso 7: Envía un mensaje de prueba

Una vez que hayas activado intervalo de servicio de atención al cliente, puedes enviar un mensaje de prueba al número de consumidor que utilizaste en el paso anterior. Para eso, haz la siguiente llamada a la API:

curl -X  POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"messaging_product": "whatsapp", "to": "16315555555","text": {"body" : "hello world!"}}'

Si la llamada se realiza correctamente, la respuesta incluirá el identificador del mensaje. Úsalo para hacer un seguimiento del progreso de los mensajes mediante Webhooks. El identificador tiene como máximo 128 caracteres.

Ejemplo de respuesta:

{
  "id":"wamid.gBGGFlaCGg0xcvAdgmZ9plHrf2Mh-o"
}

Mantente al día con las actualizaciones mensuales

Lanzaremos actualizaciones de la API de la nube el primer martes de cada mes. Estas incluirán nuevas funciones y mejoras. No es necesario que realices ninguna acción para usar las nuevas funciones, ya que la API de la nube se actualiza automáticamente.

Preguntas frecuentes

Preguntas frecuentes generales

Preguntas frecuentes sobre la implementación técnica

What is the architecture of the Cloud API?

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

Enlace permanente

Preguntas frecuentes sobre seguridad y privacidad de datos

Preguntas frecuentes sobre el cumplimiento de normativas