WhatsApp Cloud API

Para vincular una cuenta a través de la API Oficial de WhatsAp, en Trii deberá seleccionar Tipo de canal WABA CloudAPI y completar los siguientes campos.

Estos datos son extraidos de las plataformas https://developers.facebook.com/ y https://business.facebook.com/

Paso a Paso para crear una cuenta WABA CloudAPI

• El primer paso para poder crear una cuenta WABA (WhatsAPP Business Account) es Tener cuenta con permisos Administrador (Control Total) en el Portfolio Comercial de la empresa https://business.facebook.com/

• Ingresar a la configuración del Negocio

• Navegar a la sección de APPs y agregar una nueva, solicitará una cuenta para desarrolladores en https://developers.facebook.com/ si no está creada

Creación de la APP

• En en https://developers.facebook.com/ ingresar a Mis APPs

• Presionar Crear APP (ingresando directamente a la página de desarrolladores de Meta) o presionar Crear un nuevo identificador de la app (continuado desde el punto anterior).

1. En Detalles de la APP deberá completar el nombre de la misma y el correo electrónico de contacto (se recomienda colocar el correo electrónico administrador del portfolio comercial)

2. En Casos de Uso deberá seleccionar la opción Otro.

3. En Tipo de App seleccionar Negocio.

4. Por último seleccionar el Portfolio Comercial para el cual es destinada la App y presionar Crear App.

Configuración de la App

• Una vez creada la APP deberá agregar productos, en este caso el producto a agregar es WhatsApp.

• Al presionar Configurar WhatsApp, se agregará automaticante una panel para la configuración del mismo.

• En la sección Configuración de la API deberá agregar el teléfono en el sector Enviar y Recibir Mensajes en el sector De.

• Deberá Verificar mediante sms o llamada telefónica la posesión del numero (los numeros mostrados en el apartado Identificador de número de teléfono y Identificador de la cuenta de WhatsApp Business serán utilizado para la activación del número así como también en la configuración de Trii).

• En la sección Configuración deberá de configurar los parámetros de WebHook.

  1. En URL de devolución de llamada deberá completar con https://{host}.trii.com.ar/api/v1/whatsapp/cloudapi/webhook/{id_canal} donde deberá reemplazar el valor {host} por el del subdominio correspondiente a su instancia y el valor {id_canal} por el id del canal de Trii vinculado a traves de la conexion WABA CloudAPI.

  2. El token de verificación es supersecret.

  3. Luego deberá presionar Verificar y Guardar.

  4. Una vez verificados los datos y guardados deberá suscribir los campos (messages_template_status_update, messages y template_category_update).

• Una vez creada y configurada la APP deberá activar la cuenta en Postman en la seccion Enviar y Recibir Mensajes deberá completar los datos De y Para y presionar el botón Ejecutar en Postman.

• Para activar la cuenta deberá seguir los pasos 3 y 5 detallados en Get Started for BSPs.

Generar Token de usuario y Sistema

Este dato lo podrá obtener en el portfolio comercial de https://business.facebook.com/ para obtenerlo luego de crear la App deberá acceder a Users > System Users.

Allí deberá crear un nuevo Usuario del sistema el cual deberá tener rol Admin.

Una vez creado el usuario de sistema deberá vincular la App creada previamente (siempre con Control Total)y Generar nuevo Token el cual no debe vencer nunca.

1. Seleccionar App y presionar Siguiente

2. Seleccionar Caducidad del Token (Nunca)

3. Seleccionar los permisos

4. Copiar y guardar el Token de usuario

Agregar un número de Teléfono

Se retoma la configuración de la APP en https://developers.facebook.com/apps/ a partir del punto Configuración de la APP

En configuracion de la API se debe ingresar el número de teléfono presionando De: +Agregar número de Teléfono

Se añade informacion de la cuenta de WhatsApp

Luego se añade El número de teléfono de la cuenta y se verífica la cuenta con el código Recibido

Configuración del método de pago de la cuenta

Para agregar un metodo de pago en la cuenta debe presionar Configuración de Pago.

En configuración de pago de la cuenta se presiona Agregar método de pago

Seleccionar como divisa Dolar estadounidense y presionar SIguiente

Agregar Tarjeta de débito o crédito como método de pago y presionar siguiente

Completar con los datos de la arjeta y guuardar

Habilitar el número mediante la API de postman

Una vez verificado el número de WhatsApp como se indicó en Agregar un número de teléfono y configurado el Método de pago se procede a la habilitación del número de teléfono.

Para ello deberá de seleccionar el numero de la cuenta de WhatsApp, Luego escribir un numero de teléfono conocido y esperar que Meta valide que es un numero existente, por último presionar Ejecutar en Postman

En postman se creará un entorno con los datos del canal

En colleciones deberá ejectur el llamado a 2 APIs

Subscribe to your WABA y Register Phone Number

En la API Register Phone Number deberá escribir y guardar un código de 6 digitos, este será el Factor 2FA

Configuración del canal en Trii

Para configurar el canal en Trii necesitará los siguientes datos:

Meta Developer App Id

Podrá obtener este dato accediendo al enlace https://developers.facebook.com/tools/accesstoken/ allí deberá copiar el dato correspondiente al App Token que se encuentra del lado izquierdo de la barra | (es decir deberá copiar la parte numérica del App Token).

WhatsApp Phone Number Id

Este dato estará disponible en https://developers.facebook.com/ deberá seleccionar la App creada para este canal y el numero de WhatsApp a vincular, allí podrá copiar el numero correspondiente al Identificador de Número de Teléfono.

WhatsApp Business Account Id

Este dato estará disponible en https://developers.facebook.com/ deberá seleccionar la App creada para este canal y el numero de WhatsApp a vincular, allí podrá copiar el numero correspondiente al Identificador de la Cuenta de WhatsApp Business.

App Token

Aqui deberá pegar el App Token completo descripto en Meta Developer App Id

System User Acces Token:

Aqui deberá utilizar el Token obtenido en Generar Token de Usuario y Sistemas