innovaphone wiki - User contributions [en]

Courseware:IT Connect - 06.0 Managing Devices

2026-09-23T10:05:44Z

Viktor.gruenauer:

{{#moodlebook: Master Templates / V16 Templates / Connect| Managing Devices | 161 }}
[[Category:IT_Connect|{{PAGENAME}}]]

Courseware:IT Connect - 06.0 Managing Devices

2026-09-23T10:04:29Z

Viktor.gruenauer:

{{#moodlebook: Master Templates / V15 Templates / Connect| Managing Devices | 161 }}
[[Category:IT_Connect|{{PAGENAME}}]]

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-28T13:37:00Z

Viktor.gruenauer: /* Steps to setup up the Connector for Whatsapp */

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of the Connect app.

== Steps to set up the Connector for Whatsapp ==
=== 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

=== Set up===
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. It is crucial that the App Objekt exists on the PBX before you start the Onboarding process 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding. To add a phone id, your WhatsApp Business Display name as to be included in the Profile Name.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

=== Configuration ===
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID ('''MANDATORY'''). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

=== Sticker ===
Stickers are currently not supported. These messages will not be transmitted.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-28T13:35:22Z

Viktor.gruenauer: /* App (innovaphone-whatsapp) */

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of the Connect app.

== Steps to setup up the Connector for Whatsapp ==
=== 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

=== Set up===
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. It is crucial that the App Objekt exists on the PBX before you start the Onboarding process 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding. To add a phone id, your WhatsApp Business Display name as to be included in the Profile Name.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

=== Configuration ===
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID ('''MANDATORY'''). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

=== Sticker ===
Stickers are currently not supported. These messages will not be transmitted.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-27T09:06:16Z

Viktor.gruenauer: /* Steps to setup up the Connector for Whatsapp */

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of the Connect app.
== Steps to setup up the Connector for Whatsapp ==
=== 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

=== Set up===
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. It is crucial that the App Objekt exists on the PBX before you start the Onboarding process 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding. To add a phone id, your WhatsApp Business Display name as to be included in the Profile Name.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

=== Configuration ===
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID ('''MANDATORY'''). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

=== Sticker ===
Stickers are currently not supported. These messages will not be transmitted.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-27T09:03:09Z

Viktor.gruenauer:

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of the Connect app.
== Steps to setup up the Connector for Whatsapp ==
=== 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

=== Set up===
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. It is crucial that the App Objekt exists on the PBX before you start the Onboarding process 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

=== Configuration ===
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID ('''MANDATORY'''). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

=== Sticker ===
Stickers are currently not supported. These messages will not be transmitted.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-27T08:57:21Z

Viktor.gruenauer: /* Configuration */

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. It is crucial that the App Objekt exists on the PBX before you start the Onboarding process 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID ('''MANDATORY'''). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

=== Sticker ===
Stickers are currently not supported. These messages will not be transmitted.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-27T08:56:42Z

Viktor.gruenauer: /* Set up */

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. It is crucial that the App Objekt exists on the PBX before you start the Onboarding process 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID (mandatory). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

=== Sticker ===
Stickers are currently not supported. These messages will not be transmitted.

== Related Articles ==

Reference16r1:Apps/PbxManager/App Connector for WhatsApp

2026-04-22T12:50:05Z

Viktor.gruenauer:

The Settings plugin for the Connector for WhatsApp allows you to create and configure the corresponding app object. In addition, the app object can be assigned to specific configuration templates (if available).

== Add Connector for WhatsApp ==
Create a new PBX object for the Connector for WhatsApp.

'''Type ''whatsApp'''''

'''Name'''

The Long Name of the PBX object

'''SIP'''

The Name of the object

'''Connect App'''

Select the Connect app that is associated with the Connector for WhatsApp.

'''Connect Moderator'''

Select the Moderator mode of the Connect app. If this mode is not available, open the Connect object in the Advanced UI and add ''moderator'' as a mode.

'''Licenses'''

Add your license amount

== Set up ==

'''Phone PIN'''

The user must enter a 6-digit PIN. This PIN is not generated by the system. After creation, it is linked to your Phone Number ID. Afterwards you can start your onboarding as described in the [[{{NAMESPACE}}:Concept App Service Connector for Whatsapp|Concept article.]]

== Configuration ==
'''User Token'''

The user token generated by Meta is automatically stored in your configuration.

'''Mobile Number ID'''

The mobile phone number ID is assigned to you by Meta during the onboarding process. You can have up to 20 phone IDs, but verification by Meta is required.

'''App'''

Select the Connect app to process input/output from the connector. The selected app will receive incoming messages for the registered mobile number and be able to send messages from that number.

'''Zone'''

Select the Connect zone to which WhatsApp messages should be posted. The zone should correspond to the SIP ID of the Connector for WhatsApp object.

'''Connect Tags'''

Configure hashtags to be applied to messages posted via the Connector for WhatsApp.

'''Licensed'''

Select the Mobile Number ID to be licensed.

'''Message on closed answer timeframe'''

This message will be transmitted as soon as the 24 hours time frame elapsed.

== Whatsapp account information ==

Displays all relevant data used by the Connector for WhatsApp app.

== Known issues ==

== Related Articles ==

[[Courseware:IT_Plus_-_Connect_App]]
[[{{NAMESPACE}}:Concept App Service Connector for Whatsapp]]

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-22T12:47:29Z

Viktor.gruenauer: /* Known issues */

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID (mandatory). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

=== Sticker ===
Stickers are currently not supported. These messages will not be transmitted.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-22T12:46:18Z

Viktor.gruenauer:

== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 

[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 

[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. To add only a new phone number, select ''Register new phone number'' instead of completing the full onboarding.

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed in the Configuration menu.

Now you have to assign a Connect instance and zone to each phone ID (mandatory). Hashtags are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.
A custom message can be defined that will be sent once the 24-hour timeframe has elapsed.

Enable the license option for each phone ID that needs to be licensed.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Business account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

File:Set-up-whatsapp3.png

2026-04-22T12:17:37Z

Viktor.gruenauer: Viktor.gruenauer uploaded a new version of File:Set-up-whatsapp3.png

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-22T07:11:24Z

Viktor.gruenauer: /* Set up */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the Connector for Whatsapp to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to <code>https://whatsapp.innovaphone.com/whatsappsharedservice</code>. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here.

You have to assign a Connect instance, zone to each phone ID. Hashtag are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-17T08:34:26Z

Viktor.gruenauer: /* Install */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.
** Configure the license amount

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to whatsapp.innovahone.com. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.
== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here.

You have to assign a Connect instance, zone to each phone ID. Hashtag are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-17T08:04:17Z

Viktor.gruenauer: /* Configuration */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.
== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to whatsapp.innovahone.com. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.
== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here.

You have to assign a Connect instance, zone to each phone ID. Hashtag are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-17T08:02:47Z

Viktor.gruenauer:

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.
== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to whatsapp.innovahone.com. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.
== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here.
You have to assign a Connect instance, zone to each phone ID. Hashtag are optional. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-17T07:34:06Z

Viktor.gruenauer: /* WhatsApp Account Information */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.
== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to whatsapp.innovahone.com. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.
== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)
*License count

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Apps/PbxManager/App Connector for WhatsApp

2026-04-17T07:33:08Z

Viktor.gruenauer:

The Settings plugin for the Connector for WhatsApp allows you to create and configure the corresponding app object. In addition, the app object can be assigned to specific configuration templates (if available).

== Add Connector for WhatsApp ==
Create a new PBX object for the Connector for WhatsApp.

'''Type ''whatsApp'''''

'''Name'''

The Long Name of the PBX object

'''SIP'''

The Name of the object

'''Connect App'''

Select the Connect app that is associated with the Connector for WhatsApp.

'''Connect Moderator'''

Select the Moderator mode of the Connect app. If this mode is not available, open the Connect object in the Advanced UI and add ''moderator'' as a mode.

''''Service license'''

Add your license amount

== Set up ==

'''Phone PIN'''

The user must enter a 6-digit PIN. This PIN is not generated by the system. After creation, it is linked to your Phone Number ID. Afterwards you can start your onboarding as described in the [[{{NAMESPACE}}:Concept App Service Connector for Whatsapp|Concept article.]]

== Configuration ==
'''User Token'''

The user token generated by Meta is automatically stored in your configuration.

'''Mobile Number ID'''

The mobile phone number ID is assigned to you by Meta during the onboarding process. You can have up to 20 phone IDs, but verification by Meta is required.

'''App'''

Select the Connect app to process input/output from the connector. The selected app will receive incoming messages for the registered mobile number and be able to send messages from that number.

'''Zone'''

Select the Connect zone to which WhatsApp messages should be posted. The zone should correspond to the SIP ID of the Connector for WhatsApp object.

'''Connect Tags'''

Configure hashtags to be applied to messages posted via the Connector for WhatsApp.

'''Licensed'''

Select the Mobile Number ID to be licensed.

== Whatsapp account information ==

Displays all relevant data used by the Connector for WhatsApp app.

== Known issues ==

== Related Articles ==

[[Courseware:IT_Plus_-_Connect_App]]
[[{{NAMESPACE}}:Concept App Service Connector for Whatsapp]]

Reference16r1:Apps/PbxManager/App Connector for WhatsApp

2026-04-17T07:32:45Z

Viktor.gruenauer:

The Settings plugin for the Connector for WhatsApp allows you to create and configure the corresponding app object. In addition, the app object can be assigned to specific configuration templates (if available).

== Add Connector for WhatsApp ==
Create a new PBX object for the Connector for WhatsApp.

'''Type ''whatsApp'''''

'''Name'''

The Long Name of the PBX object

'''SIP'''

The Name of the object

'''Connect App'''

Select the Connect app that is associated with the Connector for WhatsApp.

'''Connect Moderator'''

Select the Moderator mode of the Connect app. If this mode is not available, open the Connect object in the Advanced UI and add ''moderator'' as a mode.

''''Service license'''
Add your license amount

== Set up ==

'''Phone PIN'''

The user must enter a 6-digit PIN. This PIN is not generated by the system. After creation, it is linked to your Phone Number ID. Afterwards you can start your onboarding as described in the [[{{NAMESPACE}}:Concept App Service Connector for Whatsapp|Concept article.]]

== Configuration ==
'''User Token'''
The user token generated by Meta is automatically stored in your configuration.

'''Mobile Number ID'''

The mobile phone number ID is assigned to you by Meta during the onboarding process. You can have up to 20 phone IDs, but verification by Meta is required.

'''App'''

Select the Connect app to process input/output from the connector. The selected app will receive incoming messages for the registered mobile number and be able to send messages from that number.

'''Zone'''

Select the Connect zone to which WhatsApp messages should be posted. The zone should correspond to the SIP ID of the Connector for WhatsApp object.

'''Connect Tags'''

Configure hashtags to be applied to messages posted via the Connector for WhatsApp.

'''Licensed'''

Select the Mobile Number ID to be licensed.

== Whatsapp account information ==

Displays all relevant data used by the Connector for WhatsApp app.

== Known issues ==

== Related Articles ==

[[Courseware:IT_Plus_-_Connect_App]]
[[{{NAMESPACE}}:Concept App Service Connector for Whatsapp]]

Reference16r1:Concept App Service Connector for Whatsapp

2026-04-02T06:52:01Z

Viktor.gruenauer:

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

Please note that only one app object can be created per instance. To create another, a separate app service instance is required.
== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to whatsapp.innovahone.com. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.
== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-30T07:10:48Z

Viktor.gruenauer:

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

[[image:whatsapp-oboarding.png]] 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. This will open a new tab in your browser which will connect to whatsapp.innovahone.com. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta (www.facebook.com/platform) and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin. In order to transmit the data, Meta must be able to connect to the Connector for WhatsApp on your Application Platform (webhook address). The reverse proxy must therefore allow connections to <dns-name of AP>/<domain-name>/whatsapp.
== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

File:Whatsapp-oboarding.png

2026-03-30T06:47:42Z

Viktor.gruenauer:

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-27T09:21:35Z

Viktor.gruenauer: /* Troubleshooting */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic
</li><li>Webserver
</li><li>Websocket client
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-25T10:21:43Z

Viktor.gruenauer:

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]The Settings plugin enable the following parameters:

;Hidden: This app has no user interface and should be hidden for users
;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.

Please note that that Connect needs to have access to the Connector for Whatsapp as well. As a result, please make sure to enable the checkbox for the Connector for Whatsapp inside the Apps tab of 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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic (only in case of media transmission problems)
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-23T10:14:36Z

Viktor.gruenauer: /* Known issues */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic (only in case of media transmission problems)
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

=== Phone Calls ===
You cannot make phone calls between WhatsApp and Connect users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-23T08:44:35Z

Viktor.gruenauer: /* Set up */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Select ''Text message'' to verify your number. You’ll receive a verification PIN via SMS. Enter it to complete the process. 
If you use a MSN that is not capable of receiving a text message, choose ''Phone call'' instead. An automated system will call you and provide the verification code. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic (only in case of media transmission problems)
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-16T13:12:25Z

Viktor.gruenauer:

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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. 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.


Within a discussion in Connect, all messages are forwarded to the sender of the WhatsApp message, not only those posted as direct replies to the incoming message. Private messages are excluded from this behavior and can only be viewed by the author and the recipient.


== Apps ==
=== App (innovaphone-whatsapp) ===
[[image:whatsapp-connector.png]]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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Choose ''Text message'' to verify your number.
Afterwards, you will receive a verification PIN via text message, which must be entered. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin.

== Configuration ==
After completing the onboarding process, the user token and phone ID from Meta are displayed here. You can assign a Connect instance, zone, and hashtags to each phone ID. Messages received via a specific mobile number ID will be posted and tagged based on this configuration.

To delete Phone numbers for a WhatsApp Business account, or the WhatsApp Business account itself, go to the Meta Business Suite:
[https://www.facebook.com/business/help/1592865014304024/] Note: Numbers are not removed from the Connector for WhatsApp settings when you delete the number in the Whatsapp Buiseness account.
To remove the numbers open the Configuration section of the plugin and remove the affected number using the delete icon.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic (only in case of media transmission problems)
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-16T12:40:34Z

Viktor.gruenauer: /* Set up */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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) ===
[[image:whatsapp-connector.png]]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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Choose ''Text message'' to verify your number.
Afterwards, you will receive a verification PIN via text message, which must be entered. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

During the onboarding process, a user token and a phone ID are created for each MSN number and stored in the Connector for WhatsApp app service. They are automatically added to the Configuration section of the plugin.

== 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.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic (only in case of media transmission problems)
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-13T12:54:53Z

Viktor.gruenauer: /* Requirements */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform. This number cannot be associated with the free version of whatsapp already.
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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) ===
[[image:whatsapp-connector.png]]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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Choose ''Text message'' to verify your number.
Afterwards, you will receive a verification PIN via text message, which must be entered. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

== 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.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic (only in case of media transmission problems)
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

== Related Articles ==

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-13T12:50:59Z

Viktor.gruenauer: /* Set up */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}



== Applies To ==

<ul><li>innovaphone System (PBX/AP) from version 16r1 upwards</li>
</li></ul>

== Requirements ==

<ul><li> innovaphone PBX
</li><li> innovaphone AppPlatform
</li><li> innovaphone myApps
</li><li> Messages App service and Connect app
</li><li> A Facebook account
</li><li> At least one valid phone number (MSN) required for the registration with the WhatsApp Business platform (no private account allowed)
</li></ul>

== Licensing ==
This product requires licensing. You will need the following license.
<ul><li>Name: innovaphone Connector für WhatsApp
</li><li>ID: Service(innovaphone-whatsapp)
</li><li>Order number: 02-00050-017
</li></ul>

== 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 ( e.g png, .jpg, .pdf, .mp4, .txt). You can find a full list here [https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media#supported-media-types here]]

[[image:Concept-connector-whatsapp.png]]

== 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) ===
[[image:whatsapp-connector.png]]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 your Connect app
** Select the moderator mode of the Connect app.
** Select a config template. Users inheriting from this template will have access to the Connect zone where WhatsApp posts are sent.

== Set up==
After the initial installation of the Connector for WhatsApp, you need to onboard the connector to the WhatsApp Business Platform. 

Go to the ''Whatsapp Settings'' Plugin in your Settings app and open ''Set Up''. 
[[image:Set-up-whatsapp1.png]] 

Next, configure any 6-digit PIN. Please store the PIN in a safe place, as it is required for the administration of your Phone IDs if they need to be deleted. 
[[image:set-up-whatsapp2.png]] 

Click ''Set Up'' to connect to a shared service operated by Innovaphone. 

[[image:set-up-whatsapp3.png]] 

Click ''Onboard'' to start an authenticated session with Meta and log in using your Facebook account. If you do not have one, you must create one. 

[[image:set-up-whatsapp4.png]] 

If you already have a WhatsApp Business Account or a Business Portfolio, you can select it here. If not, one will be created for you. Click ''Next''. 

[[image:set-up-whatsapp5.png]] 

Add the details for your Business account, such as name, email address, and country, then click ''Next''. 

[[image:set-up-whatsapp6.png]] 

Next, select Use a new or existing WhatsApp number and enter the number you want to link as your WhatsApp Business number. Important: This number must not already be linked to another WhatsApp account, either WhatsApp Business or a regular WhatsApp account. 

Choose ''Text message'' to verify your number.
Afterwards, you will receive a verification PIN via text message, which must be entered. 

[[image:set-up-whatsapp7.png]] 

Once completed, a success message will be displayed. 

[[image:set-up-whatsapp8.png]]

== 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.

== WhatsApp Account Information ==
After the Onboarding Process the plugin will show you the following Parameter:
*WhatsApp Business Account ID
*Webhook-address (This address has to be reachable from the Internet, so make sure your reverse proxy forwards the traffic to the AP)
*Phone IDs associated with Whatsapp Business (max 20 MSN numbers)

== 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:

<ul><li>HTTP client
</li><li>App Websocket
</li><li>Webserver traffic (only in case of media transmission problems)
</li></ul>

== Known issues ==
=== Whatsapp zone not visible in Connect===
The user must have access to the ''Connector for WhatsApp'' app (Users → Apps tab). Config Templates can be used to distribute the app to users.

== Related Articles ==

File:Set-up-whatsapp8.png

2026-03-13T12:50:35Z

Viktor.gruenauer:

File:Set-up-whatsapp7.png

2026-03-13T12:50:24Z

Viktor.gruenauer:

File:Set-up-whatsapp6.png

2026-03-13T12:50:12Z

Viktor.gruenauer:

File:Set-up-whatsapp5.png

2026-03-13T12:49:59Z

Viktor.gruenauer:

File:Set-up-whatsapp4.png

2026-03-13T12:49:48Z

Viktor.gruenauer:

File:Set-up-whatsapp3.png

2026-03-13T12:49:38Z

Viktor.gruenauer:

File:Set-up-whatsapp2.png

2026-03-13T12:49:26Z

Viktor.gruenauer:

File:Set-up-whatsapp1.png

2026-03-13T12:46:46Z

Viktor.gruenauer:

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T15:58:57Z

Viktor.gruenauer:

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T15:54:01Z

Viktor.gruenauer:

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T15:52:40Z

Viktor.gruenauer: /* WhatsApp Account Information */

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T15:15:59Z

Viktor.gruenauer: /* Concept */

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T15:13:26Z

Viktor.gruenauer:

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T14:27:52Z

Viktor.gruenauer: /* Install */

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T14:07:44Z

Viktor.gruenauer: /* Whatsapp zone not visible in Connect */

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T14:07:29Z

Viktor.gruenauer: /* Whatsapp zone not visible */

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-12T14:06:40Z

Viktor.gruenauer: /* Known issues */

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-11T16:00:12Z

Viktor.gruenauer: /* Install */

Reference16r1:Concept App Service Connector for Whatsapp

2026-03-11T15:28:23Z

Viktor.gruenauer:

Howto16r1:Firmware Upgrade V15r1 V16r1

2026-03-11T08:47:41Z

Viktor.gruenauer:

== Applies To ==
This information applies to:

* All 16r1 capable innovaphone devices
: For a general overview of the upgrade process and a list of supported devices with 16r1, see [[Howto:Firmware Upgrade]]
== Licenses ==
In case of cloud or rental model, don't worry about licenses.

If the system is licensed on premise, you'll need to regenerate the license file for v16 in https://portal.innovaphone.com/ and load into the system before upgrade (The system needs to have the SSC up to date).

== Migration Policy ==
Before you begin, be sure that your whole installation is running the latest 15r1 service release. 

=== TechAssist Upgrade Helper ===
* Before you start, make sure that all TechAssist tests (you will receive the required tests in the last update in the previous major version) labelled <code>Pre Upgrade: xy</code> are positive, if available
* When you are finished, make sure that all TechAssist tests (you will receive new tests with the upgrade) are positive

=== New TLS Profile ===
Please note that we have changed our TLS profiles ([[Reference16r1:IP4/General/TLS]]). The new ''Normal'' setting, which is the default value, now only allows TLS 1.3 and TLS 1.2.

== Changes visible to the end customers ==
Listed here are changes that should be communicated by resellers to end users prior to a upgrade, as the change will be visible/audible in the behaviour of the application/device.

* ''Nothing''

== Manual steps needed after upgrade ==
If the installer is not used for a new installation, some new default settings are not set. Please evaluate per app whether you want to configure the new default settings manually.

=== Connector for Microsoft 365 ===
If you plan to use the new '''Contact Search''' feature of the Connector for Microsoft 365, you need to perform two manual Steps:
# Create the '''microsoft365-api''' app object by using the Settings template
# Assign the '''microsoft365-api''' app object to every user who should be able to use the new Contact Search feature. (Of cause, you can use a template for that)
 
For a more detailed guide, please refer to the how-to article: [[Howto16r1:Configure Contact Search by Connector for Microsoft365#Creating the PBX app object using the PBX Manager Plugin]]

=== Remote Control ===
In order to use the Admin Configuration Panel of the Settings App – AP Remote Control, it is necessary to grant access to the '''admin''' API, available in the App tab of the Remote Control App object.

=== Working ===
For badge counts to work, the Working Manager app object must have '''Websocket''' and '''PbxSignal''' enabled.
For the Connect integration of the Working app, '''Websocket''', '''Services''' and '''Connect'''(in the Apps tab) must be enabled in the Working User app.

== New Apps ==
New Apps will not be installed automatically by the upgrade. The installation description of new apps is usually in the concept article. Please rate per app whether you want to install/use the new app and configure it manually.

* App Polls: [[Reference16r1:Concept App Polls]]
* App Service Conference Transcriptions [[Reference16r1:Concept_App_Service_myApps_Assistant]]
* App Service Connector for Whatsapp: [[Reference16r1:Concept_App_Service_Connector_for_Whatsapp]]

== Removed ==
The following software is no longer included.

* IP110A (can still be used with 15r1 firmware on current PBX versions)
* IP240A (can still be used with 15r1 firmware on current PBX versions)
* CA on CF card feature

== Deprecated ==
The following software is based on legacy technology, with no further development and limited maintenance and support.

* ''Nothing''

== Previously deprecated and now no longer supported ==
The following software is based on legacy technology, with no further development and no more maintenance and support.

* ''Nothing''

==Known Problems==
===Long Update-duration===
When you update, it can be up to 10 minutes before you have access to your app platform again.

== Related Articles ==
*[[Howto:Firmware_Upgrade]]
* [[Howto15r1:Firmware_Upgrade_V14r2_V15r1]]
[[Category:Howto|{{PAGENAME}}]]