Whatsapp Messaging
💬
NW WhatsApp Messaging
Extensión para Microsoft Dynamics 365 Business Central — niccoweb.com
📋 Información General
Publisherniccoweb.com
Versión27.0.0.0
Runtime AL16.0
BC Mínimov27.0
APIGraph v17.0
ℹ️ ¿Qué hace esta extensión?
NW WhatsApp Messaging integra Business Central con la
WhatsApp Business Cloud API de Meta, permitiendo enviar mensajes directamente
desde el ERP sin salir de la aplicación. La comunicación se realiza mediante llamadas HTTP
al endpoint de la Graph API, autenticadas con un Bearer Token.
👤 Usuario BC
→
📄 Página BCWhatsApp Send Messages
→
⚙️ CodeunitWhatsApp
→
🌐 Meta Graph APIv17.0
→
📱 WhatsAppDestinatario
✨ Tipos de Mensajes Soportados
📝
Texto
Mensaje de texto plano al teléfono configurado.
🖼️
Imagen
Imagen por URL pública. Admite caption opcional.
🎬
Video
Video por URL pública. Admite caption opcional.
📄
Documento (URL)
Documento accesible por URL con nombre y caption.
📎
Documento (Upload)
Selecciona un archivo local; se sube a Meta y se envía por Media ID.
🎵
Audio
Archivo de audio por URL pública.
📍
Ubicación
Coordenadas GPS con nombre y dirección. Se detectan automáticamente al abrir la página.
👤
Contacto
Tarjeta vCard con nombre y teléfono del contacto.
🏠
Dirección de Cliente
Envía la ficha de dirección de un cliente de Business Central.
🔘
Botones Interactivos
Mensaje con 2 botones personalizables (ej. Aprobar / Rechazar).
⚙️ Configuración Inicial
-
1En Business Central, buscar la página WhatsApp Setup.
-
2Ingresar el Token de acceso obtenido desde el portal de Meta for Developers. Es un Bearer token de larga duración.
-
3Ingresar el Test Phone: número destino en formato internacional sin espacios. Ejemplo: 5491112345678
-
4Guardar. La configuración se persiste en la tabla WhatsApp Setup.
🚀 Cómo Enviar un Mensaje
-
1Buscar la página WhatsApp Send Messages en Business Central.
-
2Completar los campos del grupo correspondiente al tipo de mensaje que se desea enviar.
-
3Hacer clic en la acción de la barra superior (ej. Send Text Message, Send Image, etc.).
-
4Si el envío es exitoso, BC muestra un mensaje de confirmación. En caso de error, se muestra el código HTTP y la descripción.
📸 Capturas de Pantalla
🔗 Integración con la API de Meta
La extensión utiliza la WhatsApp Business Cloud API mediante llamadas HTTP desde el codeunit WhatsApp (ID 50950).
# Envío de mensajes
POST https://graph.facebook.com/v17.0/{phone-number-id}/messages
Authorization: Bearer <TOKEN>
Content-Type: application/json
# Subida de archivos (Upload & Send)
POST https://graph.facebook.com/v17.0/{phone-number-id}/media
Authorization: Bearer <TOKEN>
Content-Type: multipart/form-data; boundary=...
📌 El proceso de Upload & Send realiza dos llamadas: primero sube el archivo y obtiene un Media ID, luego envía el mensaje referenciando ese ID.
POST https://graph.facebook.com/v17.0/{phone-number-id}/messages
Authorization: Bearer <TOKEN>
Content-Type: application/json
# Subida de archivos (Upload & Send)
POST https://graph.facebook.com/v17.0/{phone-number-id}/media
Authorization: Bearer <TOKEN>
Content-Type: multipart/form-data; boundary=...
📦 Objetos AL
| Tipo | ID | Nombre | Descripción |
|---|---|---|---|
| Table | 50950 | WhatsApp Setup | Almacena el Token y el teléfono de prueba |
| Page | 50950 | WhatsApp Setup | Página de configuración (tipo Card) |
| Page | 50951 | WhatsApp Send Messages | Página principal de envío (tipo Document) |
| Codeunit | 50950 | Lógica de negocio e integración con la API | |
| PermSet | 50950 | Permisos RIMD sobre todos los objetos |
🛡️ Permisos
El permission set whatsapp debe asignarse a todos los usuarios que utilicen la extensión:
📊 Table Data — WhatsApp SetupRIMD
🗄️ Table — WhatsApp SetupExecute
⚙️ Codeunit — WhatsAppExecute
📄 Page — WhatsApp Send MessagesExecute
⚙️ Page — WhatsApp SetupExecute
📝 Requisitos Previos
- ✓Business Central versión 27.0 o superior.
- ✓Cuenta de WhatsApp Business con acceso a la Cloud API de Meta.
- ✓Token de acceso válido desde el Meta for Developers Portal.
- ✓Phone Number ID registrado en la aplicación de Meta (configurado en el codeunit).
💬
NW WhatsApp Messaging
Extension for Microsoft Dynamics 365 Business Central — niccoweb.com
📋 General information
Publisherniccoweb.com
Version27.0.0.0
AL Runtime16.0
Minimum BCv27.0
APIGraph v17.0
ℹ️ What does this extension do?
NW WhatsApp Messaging integrates Business Central with Meta's WhatsApp Business Cloud API, allowing users to send messages directly from the ERP without leaving the application. Communication uses HTTP calls to the Graph API endpoint authenticated with a Bearer Token.
👤 BC User
→
📄 BC PageWhatsApp Send Messages
→
⚙️ CodeunitWhatsApp
→
🌐 Meta Graph APIv17.0
→
📱 WhatsAppRecipient
✨ Supported message types
📝
Text
Plain text message sent to the configured phone number.
🖼️
Image
Image from a public URL with an optional caption.
🎬
Video
Video from a public URL with an optional caption.
📄
Document (URL)
Document available through a URL, including name and caption.
📎
Document (Upload)
Select a local file, upload it to Meta and send it using its Media ID.
🎵
Audio
Audio file sent from a public URL.
📍
Location
GPS coordinates with a name and address, detected when opening the page.
👤
Contact
vCard containing the contact name and phone number.
🏠
Customer address
Sends a Business Central customer address card.
🔘
Interactive buttons
Message with two customisable buttons, such as Approve and Reject.
⚙️ Initial setup
- 1Open the WhatsApp Setup page in Business Central.
- 2Enter the long-lived access Token obtained from the Meta for Developers portal.
- 3Enter the Test Phone in international format without spaces. Example: 5491112345678
- 4Save. The settings are stored in the WhatsApp Setup table.
🚀 How to send a message
- 1Open the WhatsApp Send Messages page.
- 2Complete the fields in the section corresponding to the message type.
- 3Choose the relevant action, such as Send Text Message or Send Image.
- 4Business Central confirms a successful send or displays the HTTP status and error description.
📸 Screenshots
🔗 Meta API integration
The extension uses the WhatsApp Business Cloud API through HTTP requests made by the WhatsApp codeunit (ID 50950).
# Send messages
POST https://graph.facebook.com/v17.0/{phone-number-id}/messages
Authorization: Bearer <TOKEN>
Content-Type: application/json
# Upload files (Upload & Send)
POST https://graph.facebook.com/v17.0/{phone-number-id}/media
Authorization: Bearer <TOKEN>
Content-Type: multipart/form-data; boundary=...
📌 Upload & Send performs two calls: it uploads the file and obtains a Media ID, then sends a message referencing that ID.
POST https://graph.facebook.com/v17.0/{phone-number-id}/messages
Authorization: Bearer <TOKEN>
Content-Type: application/json
# Upload files (Upload & Send)
POST https://graph.facebook.com/v17.0/{phone-number-id}/media
Authorization: Bearer <TOKEN>
Content-Type: multipart/form-data; boundary=...
📦 AL objects
| Type | ID | Name | Description |
|---|---|---|---|
| Table | 50950 | WhatsApp Setup | Stores the access token and test phone number |
| Page | 50950 | WhatsApp Setup | Card-type setup page |
| Page | 50951 | WhatsApp Send Messages | Main Document-type sending page |
| Codeunit | 50950 | Business logic and API integration | |
| PermSet | 50950 | RIMD permissions for every extension object |
🛡️ Permissions
Assign the whatsapp permission set to every user of the extension:
📊 Table Data — WhatsApp SetupRIMD
🗄️ Table — WhatsApp SetupExecute
⚙️ Codeunit — WhatsAppExecute
📄 Page — WhatsApp Send MessagesExecute
⚙️ Page — WhatsApp SetupExecute
📝 Prerequisites
- ✓Business Central version 27.0 or later.
- ✓A WhatsApp Business account with access to Meta's Cloud API.
- ✓A valid access token from the Meta for Developers portal.
- ✓A Phone Number ID registered in the Meta application and configured in the codeunit.
Comentarios
Publicar un comentario