innovaphone wiki - User contributions [en]

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}}]]

Reference16r1:Concept App Service Working

2026-03-11T08:34:58Z

Viktor.gruenauer: /* Apps */

The Working App is used to record working hours and manage absences. The Working User app can be used to start/stop time tracking and create vacation requests. There is also an admin app (Working Manager) which allows users to view working hours and approve vacation requests.

== Applies To ==

* innovaphone PBX from version 16r1

==Requirements==
* innovaphone PBX
* innovaphone Application Platform
* innovaphone myApps
* Firmware V16r1 beta1 or higher
* License “App(innovaphone-working)” (order no. 02-00050-010) per application-user

==Concept==

The innovaphone Service Working App is an application for digital time and absence management.

It consists of two parts:

* '''Working User App''' – used by employees to track their working hours (via clock-in/clock-out or manual entries) and to manage absence requests such as vacation or leave. Time entries and vacation requests must be confirmed (=submitted) before they appear in the admin app. Once confirmed, they can no longer be edited.
* '''Working Manager App''' – used by administrators or managers to view and manage working time and absence information for all users. It also allows approval or rejection of vacation requests and provides access to configuration settings.

==How it works==

The first time a user starts the Working App on myApps a new entry is created in the database for this user, based on the "Name" of this user, which will be used to store all the working hours entries, vacation days, sick days and national holidays. Entering the working hours is a two step task, because after defining the start/stop time it is also necessary to "confirm/submit" these hours as correct, after the confirmation is done the user can't change them anymore and they will be displayed on the admin app.

In the Working manager App the list of the users' names is based on the "Display Name", if no DN is set then the "Name" will be used. Once the users have opened the working app at least once, they will appear in the list of all users in the Working Manager App. The app adds a red mark when an user does not fulfill the working hours regulation.

== Features ==
=== Working ===
===== Working time tracking and costume work types =====

* Work time account: Overview of the current work time balance
* Add pre-defined labels to working times

===== Working time regulations =====

*Timeout to submit entries (days): max interval the user has to submit the working hours.
* Min break time after 6 hours: min break time if the user has worked more than 6 hours.
* Min break time after 9 hours: min break time if the user has worked more than 9 hours.
* Default working hours

===== Groups/Group rights =====

* Groups can be defined
* Only the managers of the groups can see the users on the group on the Working Manager App
* Working types only available for the users on the group can be configured
* Enable/disable restrictions to submit working hours for the users on the group
* Enable/Disable verification by manager before submission to Human Resources

===== Archiving working times of deleted employees =====

===== User replication: New users appear once assigned the Working User App =====
=== Absences ===

==== vacation management ====

* Creating and approving vacation requests
* Define vacation rules in general and user-specific terms

==== holidays and sick days ====

* Entering sick days and public holidays

== Apps ==
=== innovaphone-working ===
[[Image: Innovaphone-working.png|innovaphone-working.png/|/Innovaphone-working.png]]
This is an app (Working User), where the user can enter the working hours, holidays, sick and vacation days. This can be done by clicking on the start/stop button. The user have also a calendar view to add, edit or delete working hours.
Parameters: 
;Websocket: to set a websocket connection.
;Services: API which is used to get access to APIs provided by other App Services.
;Connect: Needed to access the Connect App and to create a zone for working.

=== innovaphone-working-api ===
[[Image: Innovaphone-working-api.png|innovaphone-working-api.png/|/Innovaphone-working-api.png]]
This is a hidden app (Working Api), where the myApps session is been monitorized when the autostart/stop of the working times is enabled on the Working User App.

Parameters:
;Websocket: to set a websocket connection.
;Hidden: to configure the app as hidden.
;Admin: to get the app object name where to send the notifications.
;PbxApi: to send the notifications.

=== innovaphone-working-client-api ===
[[Image: Innovaphone-working-api.png|innovaphone-working-api.png/|/Innovaphone-working-api.png]]
This is an app needed to provide the Working Service API, so that other apps can start/stop working times. The Working Service API app is also a hidden app. The Settings plugin also sets the hidden function. This app should be granted to apps that use it, not to users.

Parameters:
;Websocket: to set a websocket connection.

=== innovaphone-working-manager ===
[[Image: Innovaphone-working-admin.png‎|innovaphone-working-admin.png/|/Innovaphone-working-admin.png]]
This is an admin app (Working Manager), where an administrator (i.e. Human Resources) can see the users' working hours. Several settings like the working hours per day can be configured per user and they are set to 8 hours from monday to friday by default.
Parameters:
;Websocket: to set a websocket connection.
;PbxSignal: Needed for the Badge Counts

Now "hr" must be entered as Mode on the app object on the PBX. With that now there are 2 workingmanager apps for the user-objects avaiable: 
workingmanager and 
workingmanager~hr. 
The administrator needs both.
* workingmanager: the managers on the group can only see the users on the group (no hamburger menu avaiable)
* workingmanager~hr: all the users can be seen there and all the configurations are available

Also some config items can be edited on the hamburguer menu:

* General settings

* Default working hours: workings hours defined per day when a user opens the app for the first time, which can be modified per user on the Admin App (Working Manager).

* Rights
** Config groups 

=== Public Holidays API ===
[[Image: Innovaphone-working-api.png|innovaphone-working-api.png/|/Innovaphone-working-api.png]]
This API provides public holiday data for other apps. It allows them to check whether a specific date is a public holiday in a given country or region.

Parameters:
;Websocket: to set a websocket connection.
;Hidden: to configure the app as hidden.

== Import and export of existing tracked time and absences with the help of CSV ==
=== CSV export ===
The users' data can be exported and imported on CSV format. There are some fixed fields that are available for the import and the export. There are also some other fields that are only displayed on the export file just as extra information, which are marked with (*).

'''Users'''

The fields that come with the CSV are the SIP, GUID, domain, display name, the defined working hours per day and the personal number.
&sip;&guid;&domain;&dn;&monday;&tuesday;&wednesday;&thursday;&friday;&saturday;&sunday;&p_number 
atlantis;null;innovaphone.com;Atlantis;8;8;8;8;8;0;0;0

'''Absences'''

The fields that come with the CSV are the SIP, the start timestamp, the working hours, label ('''vacation''' for a vacation day, '''hvacation''' for a 1/2 day vacation, '''holiday''' for national holidays, '''sick''' for sick leave), confirmed (if the absence has been submitted), date, and the personal number.
&sip;&start;&duration;&label;&confirmed;&date;&p_number 
atlantis;1712181600000;8;hvacation;true;2024-04-04;0

'''Times'''

The fields that come with the CSV are the SIP, the start timestamp, the stop timestamp, confirmed (if has been submitted), the display name, the personal number, the start date, the start time, the stop date, the stop time, the amount of hours and the label (if a type has been selected).
&sip;&start;&stop;&confirmed;&dn;&p_number;&start_date;&start_time;&stop_date;&stop_time;&hours;&label 
atlantis;1712651520199;1712651700199;true;Atlantis;0;2024-04-09;10:32:00.199+00:00;2024-04-09;10:35:00.199+00:00;0,1;

=== CSV import ===
'''Users'''

The fields that should come with the CSV are the SIP, GUID, domain, display name, the defined working hours per day and the personal number.
&sip;&guid;&domain;&dn;&monday;&tuesday;&wednesday;&thursday;&friday;&saturday;&sunday;&p_number 
atlantis;null;innovaphone.com;Atlantis;8;8;8;8;8;0;0;0

'''Absences'''

The fields that should come with the CSV are the SIP, the start timestamp, duration (the working hours), label ('''vacation''' for a vacation day, '''hvacation''' for a 1/2 day vacation, '''holiday''' for national holidays, '''sick''' for sick leave), confirmed (if the absence has been submitted) and date (if present timestamp will be ignored). The date must always have the english format, i.e. MM-DD-YYYY.
&sip;&start;&duration;&label;&confirmed;&date 
atlantis;1712181600000;8;hvacation;true;2024-04-04

'''Times'''

The fields that should come with the CSV are the SIP, the start timestamp, the stop timestamp, confirmed (if has been submitted).
&sip;&start;&stop;&confirmed 
atlantis;1712651520199;1712651700199;true

Parameters:
;workingmanager: the name of the working admin app.

== Settings Plugins ==

=== Working ===

With the Working plugin App Objects can be created, edited and deleted on the PBX.

=== Settings Plugin - Configuration ===
General settings for the app can be configured within this area.

* '''PBX Name:''' This refers to the name of the MasterPBX in the respective system environment. This setting must be set correctly for user replication and other functions to work.
* '''Connect Name:''' The H323 name of the Connect app must be configured here. This is usually “connect,” but it depends on the individual setup of the system.
* '''Connect Groups:''' Here you can define a comma-separated list of PBX group names to be used for Connect integration in private posts. This is necessary in order to be able to include separate PBX groups, such as the human resources department, in private posts in addition to department heads.
* '''Language for connectsposts''': Integration with the Connect app and thus the creation of “posts” is carried out from a central location. The language can be set for these posts. Currently, there is ‘de’ for German and “en” for English.

==Configuration==
* Install the Working App with the new AP app installer available in the Settings . ''Hint : after the installation done, close and open again the Settings to refresh the list of the installed app (the coloured plug-in)''
* Create a new PBX Object for the Working User, Working Manager and Working API Apps with the Settings Plugin.
* Assign the Working User (to normal users) and Working Manager App (to administration for example Human Resources) by selecting the config template that should include the App.
* Assign the Working API to all the users, so users can use the auto start/stop and push notifications.
* Assign license "App(innovaphone-working)" via config template or directly to all users using the APP.
* Open the object workingmanager / App / Modes: (insert here:) hr.
* Open the object Config Admin / Apps / workingmanager~hr (select).
* Set configuration settings on the "burger" menu of the Working Manager App (i.e. Reports Interval in weeks, groups and types configuration...).

==Troubleshooting==
Trace flags for App on App Platform:
*App
*App Database
*App Websocket

Trace flags for myApps Client:
*Browser Console

==Known issues==

==Related Articles==
* [https://sdk.innovaphone.com/14r2/web1/com.innovaphone.working/com.innovaphone.working.htm SDK Documentation - Working API]
* [https://sdk.innovaphone.com/14r2/doc/service/Working.htm SDK Documentation - Working Client API]

Reference16r1:Apps/PbxManager/App Working

2026-03-10T12:16:20Z

Viktor.gruenauer: /* Configuration */

{{FIXME|reason=This product is in the beta phase and is not yet finished}}
This PBX Manager Plugin contains 2 section:
* Add, edit or delete Working App on the PBX.
* Configuration: Setting target Master PBX .

== Configuration ==
; PBX Name
: This field specifies the master PBX to ensure that searches and data replication are performed on the correct PBX
; Connect Name
: The H323 name (SIPid) of the Connect app must be configured here. This is usually ''connect'', but it depends on the individual setup of the system.
; Connect Groups
: Here you can define a comma-separated list of PBX group names that can be used for Connect integration in private posts. This allows separate PBX groups, such as the Human Resources department, to be included in private posts alongside department heads.
; Language for connectsposts
: Integration with the Connect app and thus the creation of “posts” is carried out from a central location. The language can be set for these posts. Currently, there is ‘de’ for German and “en” for English.

== Add an App ==
; <nowiki>Name: </nowiki>
: The name displayed for the App Object.

'''SIP:'''

: The sip from the App Object, which must be unique

'''Config templates:'''

: Select which config templates will allow to access the App Object.

== App objects ==
; Working User
: This is an app, where the user can enter the working hours, holidays, sick and vacation days

; Working Manager

:This is an app that allows you to monitor working times, there are two types of rights:

: - The Human Resources view where all working times can be viewed
: - The Manager view, where managers only see the working times of the associated group
; Working API
: This is a hidden app, where the myApps session is been monitorized when the autostart/stop of the working times is enabled on the Working User App.

;Working Service API
: This is an app needed to provide the Working Client API, so that other apps can start/stop working times.

;Public Holidays API
: This API provides public holiday data for other apps. It allows them to check whether a specific date is a public holiday in a given country or region.