Whatsapp

💬

NW WhatsApp Messaging

Extension for Microsoft Dynamics 365 Business Central — niccoweb.com

v27.0.0.0

📋 General Information

Publisherniccoweb.com

Version27.0.0.0

AL Runtime16.0

Min. BCv27.0

APIGraph v17.0

ℹ️ What does this extension do?

NW WhatsApp Messaging integrates Business Central with Meta's WhatsApp Business Cloud API, allowing messages to be sent directly from the ERP without leaving the application. Communication is handled via 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 to the configured phone number.

🖼️

Image

Image via public URL. Optional caption supported.

🎬

Video

Video via public URL. Optional caption supported.

📄

Document (URL)

Document accessible by URL with filename and caption.

📎

Document (Upload)

Select a local file; it is uploaded to Meta and sent via Media ID.

🎵

Audio

Audio file via public URL.

📍

Location

GPS coordinates with name and address. Auto-detected when the page opens.

👤

Contact

vCard with contact name and phone number.

🏠

Customer Address

Sends the address details of a Business Central customer.

🔘

Interactive Buttons

Message with 2 customizable reply buttons (e.g. Approve / Reject).

⚙️ Initial Setup

• 1
  In Business Central, search for the page WhatsApp Setup.
• 2
  Enter the Token obtained from the Meta for Developers portal. This is a long-lived Bearer token.
• 3
  Enter the Test Phone: destination number in international format without spaces. Example: 5491112345678
• 4
  Save. The configuration is stored in the WhatsApp Setup table.

🚀 How to Send a Message

• 1
  Search for the page WhatsApp Send Messages in Business Central.
• 2
  Fill in the fields of the corresponding group for the message type you want to send.
• 3
  Click the action in the top action bar (e.g. Send Text Message, Send Image, etc.).
• 4
  If successful, BC shows a confirmation message. On error, the HTTP status code and description are displayed.

📸 Screenshots

🔗 Meta API Integration

The extension uses the WhatsApp Business Cloud API via HTTP calls from 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 media files (Upload & Send)
POST https://graph.facebook.com/v17.0/{phone-number-id}/media
Authorization: Bearer <TOKEN>
Content-Type: multipart/form-data; boundary=...

📌 The Upload & Send process makes two calls: first it uploads the file and obtains a Media ID, then it sends the message referencing that ID.

📦 AL Objects

Type	ID	Name	Description
Table	50950	WhatsApp Setup	Stores the API Token and test phone number
Page	50950	WhatsApp Setup	Setup configuration page (Card type)
Page	50951	WhatsApp Send Messages	Main messaging page (Document type)
Codeunit	50950	WhatsApp	Business logic and API integration
PermSet	50950	whatsapp	RIMD permissions for all objects

🛡️ Permissions

The whatsapp permission set must be assigned to all users of this extension:

📊 Table Data — WhatsApp SetupRIMD

🗄️ Table — WhatsApp SetupExecute

⚙️ Codeunit — WhatsAppExecute

📄 Page — WhatsApp Send MessagesExecute

⚙️ Page — WhatsApp SetupExecute

📝 Prerequisites

• ✓
  Business Central version 27.0 or higher.
• ✓
  A WhatsApp Business account with access to Meta's Cloud API.
• ✓
  A valid access token generated from the Meta for Developers Portal.
• ✓
  A Phone Number ID registered in the Meta app (configured in the codeunit).

© 2026 niccoweb.com — NW WhatsApp Messaging v27.0.0.0 — All rights reserved.