WhatsApp Business API permite a las empresas comunicarse con sus clientes a través de WhatsApp. Permite a las empresas enviar mensajes, recibir mensajes y automatizar ciertos aspectos de la comunicación con el cliente.

Contenido

- 1.1 Cuenta Business
- 1.2 Verificar negocio en Meta
  - 1.2.1 Proveedor
  - 1.2.2 Campaña
- 1.3 Tipo de mensajes
  - 1.3.1 Ubicación
  - 1.3.2 Mensajes interactivos
    - 1.3.2.1 Lista de botones
    - 1.3.2.2 Botones Responder
  - 1.3.3 Plantillas
    - 1.3.3.1 Texto
    - 1.3.3.2 Imagen
- 1.4 NGINX
2 Configuración de la aplicación en Meta.
- 2.1 Inicio de sesión
- 2.2 Home
- 2.3 Crear aplicación
- 2.4 Configurar productos para la aplicación
  - 2.4.1 WhatsApp
  - 2.4.2 Webhooks
  - 2.4.3 Inicio de sesión
- 2.5 Documentación de Meta

Cuenta Business

Para la configuración ingresar al portal: https://developers.facebook.com/

Antes de comenzar con la configuración del proveedor, necesitamos algunas cosas:

Cuenta de Meta miembro de una empresa con una cuenta comercial.
Aplicación creada en el portal de Meta.
WhatsApp, Webhook, Inicio sesión con Facebook agregado como productos a la aplicación.
Permiso para editar la configuración de la API.
Número de móvil verificado.

Los pasos para realizar estas configuraciones se encuentran al final de la pagina. Configuración de la aplicación en Meta.

Verificar negocio en Meta

Para obtener la verificación oficial de negocio en Meta, puedes visitar el siguiente enlace donde obtendrás un paso a paso detallado sobre como obtener esta verificación para lograr una mayor confianza en los clientes.

Proveedor

Inicie sesión en uContact con un usuario con permisos para crear proveedores de SMS.

Luego vamos a Administrador → Proveedores → SMS

Seleccionamos WhatsApp de la lista de proveedores y completamos los campos:

Nombre

Nombre identificador del proveedor

Nombre de usuario

ID de aplicación

Contraseña

Identificador secreto

SMS desde

Identificación del número de teléfono

Id de la cuenta WhatsApp

Identificación de la cuenta de WhatsApp. Este campo es opcional pero es necesario si se quieren sincronizar las plantillas de la cuenta.

Activar con Facebook, debe iniciar sesión con el administrador de la cuenta en Meta de la aplicación.

Mensajes por segundo, limite de mensajes que serán enviados por segundo por el proveedor.

Mensajes por segundo Si es 0 no limita la cantidad de mensajes que se podrán enviar por segundo

Acepte los permisos solicitados y estamos listos.

Campaña

Seleccione un proveedor de WhatsApp.

Ponga la identificación del número de teléfono en el campo del puerto.

Recuerde agregar miembros a la campaña.

Tipo de mensajes

Además de los tipos comunes de mensajes, como texto y adjuntos, WhatsApp Business ofrece mensajes interactivos, plantillas y ubicación.

Ubicación

Mensajes del tipo Ubicación permite a los negocios enviar la ubicación precisa de lugares de interés.

Location:-34.92403016332158,-56.158280428772684:Shopping Punta Carretas:Montevideo, Uruguay

Mensajes interactivos

Los mensajes interactivos brindan a los usuarios una forma más fácil de encontrar y seleccionar lo que quieren de su empresa en WhatsApp. Durante las pruebas, los chatbots que utilizan funciones de mensajería interactiva lograron un aumento significativo en las tasas de respuesta y las conversiones en comparación con los bots basados en texto.

Formato JSON aceptados Formato de proveedores WhatsApp - uContact v6 Español - Confluence (atlassian.net)

Lista de botones

List;	Indicates that a Button List message is starting.

List;	Indicates that a Button List message is starting.
title	TEXT Título de la lista que se muestra en la parte superior.
header	TEXT Texto mostrado en el botón del menú.
body	TEXT Texto mostrado en el cuerpo del mensaje.
options	TEXT Opciones del menu,
footer	TEXT Texto mostrado en el pie de página del mensaje.

Mensajes que incluyen un menú con un máximo de 10 opciones. Este tipo de mensaje brinda a los usuarios una forma más simple y consistente de hacer una selección cuando interactúan con una empresa.

Ejemplo:

List;
title: Soporte uContact
header:Menu
body: como podemos ayudarte? seleccione una de las opciones.
1-Telefonía
2-SMS
3-WhatsApp
4-Correo electrónico
5-Chat web
6-Facebook
7-Mensajero
8-Otro
footer:El servicio de soporte está disponible entre las 9 am a 6 pm.

Botones Responder

Mensajes que incluyen un máximo de tres opciones, cada una de las cuales es un botón. Este tipo de mensaje brinda a los usuarios una forma más rápida de realizar una selección en un menú cuando interactúan con una empresa. Los botones de respuesta ofrecen la misma experiencia de usuario que las plantillas interactivas con botones.

Ejemplo:

Buttons;
body;Califique su experiencia con uContact
header;image;https://mma.prnewswire.com/media/1098841/Net2Phone_Logo.jpg?p=facebook
1-Muy buena
2-Buena
3-Mala

Plantillas

Las plantillas de mensajes le permiten brindar una experiencia de conversación más rica que los mensajes de texto estándar al integrar botones, imágenes, listas y otros elementos junto con el texto en un solo mensaje. Las plantillas se pueden usar para muchos propósitos, como mostrar información del producto, pedirle al destinatario del mensaje que elija entre un conjunto predeterminado de opciones o mostrar resultados de búsqueda.

Para crear, modificar o eliminar las plantillas es necesario ingresar al meta portal como administración de la aplicación: https://business.facebook.com. En el menú ubicado en la esquina superior izquierda, acceda a las herramientas de la cuenta y haga clic en plantillas de mensajes.

Uso sincronizado de las planillas con en uContact:
Templates con respuestas predefinidas

Si se opta por no sincronizar las planillas, se pueden usar de la siguiente manera:

Las propiedades de la plantilla están separadas por punto y coma.
hsm: Indica que el siguiente mensaje es de tipo plantilla.
Nombre: El nombre con el que se registró la plantilla en el meta portal.
Idioma: El idioma con el que se registró la plantilla.
Tipo: Define el tipo de encabezado de la plantilla, los disponibles son texto, imagen, video, ubicación, documento.
Cabecera variable: texto sin formato si el tipo es texto, o URL del archivo adjunto si el tipo no es texto.
cuerpo variable
Tipo variable: el tipo puede ser texto, fecha_hora, moneda.
Variable en botones
Tipo variable: el tipo puede ser texto, carga útil.
Se requiere hsm, Nombre, Idioma, Tipo.
*En caso de que la plantilla no tenga alguna de las propiedades, se debe dejar en blanco separada por punto y coma.

Ejemplos:

Texto

hsm;sample_issue_resolution;es;;text-John

Imagen

hsm;sample_purchase_feedback;es;image;https://desarrollo.ucontactcloud.com/attachments/20230418/66c38ee1-bec9-462b-a844-9baed8eece43.download.png;text-uContact

NGINX

Para recibir los mensajes en uContact es necesario agregar el siguiente fragmento de código a la configuración de NGINX.

location /Integra/resources/Whatsapp/{
     proxy_pass http://localhost:8085;
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

location /Integra/resources/WhatsappAuth/{
     proxy_pass http://localhost:8085;
     proxy_set_header Host $host;
     proxy_set_header X-Real-IP $remote_addr;
     proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

Configuración de la aplicación en Meta.

En el caso de WhatsApp Business es necesario contar con una cuenta de facebook y registrarse como desarrollador de Meta.

En caso de no contar con una cuenta como desarrollador de Meta podemos crearla en el siguiente enlace:

https://developers.facebook.com/async/registration

Inicio de sesión

Social technologies | Meta for Developers

Home

En la siguiente pantalla seleccionamos mis aplicaciones.

Crear aplicación

Click en crear aplicación

Seleccionar su portfolio comercial. Click en siguiente

Seleccionar la opción “Otro” y darle click a siguiente.

Seleccionar la opción empresa y darle click en siguiente.

Completar el nombre de la aplicación, el email de contacto y darle click a crear la aplicación.

Configurar productos para la aplicación

En la siguiente pantalla debemos seleccionar los productos que debemos configurar para poder usar la aplicación. Los siguientes son WhatsApp, Webhooks, Inicio de sesión con Facebook para empresa.

A continuación se explicará cómo configurar cada producto.