WhatsApp Business
- uContact dev
- Santiago CouƱago
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
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.
Para mas informaciĆ³n dirigirse a la documentaciĆ³n de meta. Link
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.
ConfiguraciĆ³n
Webhook
En la ventana de configuraciĆ³n de WhatsApp, secciĆ³n webhook, agrega lo siguiente:
URL de devoluciĆ³n de llamada: https://<instancia>.ucontactcloud.com/Integra/resources/Whatsapp/webhook
Verificador de ID: 1nt3gr4!
Campos de webhook: suscribirse a mensajes.
Recuerde agregar la configuraciĆ³n necesaria a NGINX
Inicio de sesiĆ³n
En la ventana de inicio de sesiĆ³n con Facebook agregar lo siguiente en el campo de URI de redireccionamiento de OAuth vĆ”lidos:
https://<instancia>.ucontactcloud.com/Integra/resources/WhatsappAuth/oauth
Recuerde agregar la configuraciĆ³n necesaria a NGINX
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
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. |
|---|---|
title | status:TEXT TĆtulo de la lista que se muestra en la parte superior. |
header | status:TEXT Texto mostrado en el botĆ³n del menĆŗ. |
body | status:TEXT Texto mostrado en el cuerpo del mensaje. |
options | status:TEXT Opciones del menu, |
footer | status: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.
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;
}Ā
DocumentaciĆ³n de Meta
Plataforma de Meta
Registro de usuario:
Crear aplicaciĆ³n y agregar los productos:
Agregar numero de telƩfono:
Ā