Reference16r1:Concept App Service Connector for Whatsapp
Applies To
- innovaphone System (PBX/AP) from version 16r1 upwards
Requirements
- innovaphone PBX
- innovaphone AppPlatform
- innovaphone myApps
- Messages App service and Connect app
- A Facebook account
Licensing
This product requires licensing. You will need the following license.
- Name: innovaphone Connector für WhatsApp
- ID: Service(innovaphone-whatsapp)
- Order number: 02-00050-017
Concept
The Connector for WhatsApp establishes a connection to the WhatsApp Business Platform and to a Connect instance. Messages can be exchanged between Connect users and WhatsApp users. Supported message types include text messages, locations, contacts, reactions, and media files (.png, .jpg, .pdf, .mp4, .txt).
How it works
Messages written by WhatsApp users will be displayed in Connect alsongside with the Name of the Sender. By answering within the feed, the message is sent to the whatsapp-account of the initiator of the conversation.
Please note that a discussion can only be initiated by the WhatsApp user. This is a security mechanism to prevent spam for WhatsApp users. A Connect user can reply to a message from WhatsApp within a 24-hour time window. If there was no response within the time frame, a new discussion will be created in Connect when a new message from the same number is received.
Apps
App (innovaphone-whatsapp)
The Settings plugin enable the following parameters:
- Websocket
- Connection between the PBX and the App Platform.
- Services
- API which is used to get access to APIs provided by other App Services
- connect
- The connector for Whatspp needs access to connect to the Connect App
- connect~moderator
- The Connector for Whatsapp needs moderator rights to access the Connect App.
Install
- Install the WhatsApp Connector via the app Installer Settings plugin.
- Create a new PBX Object for the WhatsApp Connector with the Settings Plugin of the Connector for Whatsapp.
- Configure a name and SIPid
- Select the Connect app you want to use as the frontend.
- Select moderator mode of the Connect app.
Set up
Configuration
Add the mobile number IDs you received from Meta. Messages received via a specific mobile number ID can be assigned to a Connect zone and tagged with hashtags.
Troubleshooting
If problems occur, please send us a log of the app service. Before reproducing the issue, delete the current contents of the log. The following trace flags should be enabled:
- HTTP client
- App Websocket
- Webserver traffic (only in case of media transmission problems)
