Configuring Pexip Infinity as a Google Hangouts Meet gateway

To route calls to Hangouts Meet conferences directly via the Pexip Distributed Gateway you need:

• To decide on an alias pattern that participants will dial to access the Hangouts Meet conferences.
  • The alias pattern will typically include the meeting code, for example the pattern could be just <meeting code> or <meeting code>@<domain> i.e. the meeting code and then, optionally, the domain of your Pexip Infinity platform, for example 123456@example.com to access a Hangouts Meet conference with a meeting code of 123456.
  • You can also configure within G Suite a PIN prefix (8, for example) to force all meeting codes to start with that prefix. This is typically required if you have a conflicting dial plan on your video conferencing side that could clash with your Hangouts Meet meeting codes. See Configuring G Suite for Google Hangouts Meet integration for more information.

• One or more Call Routing Rules that match that alias pattern and, if necessary, transform it such that it contains just the Hangouts Meet meeting code which it can then use to connect to the conference. You can use multiple rules to differentiate between devices that are to be treated as trusted or not from Pexip Infinity's perspective, and hence which type of Access token is selected and whether Treat as trusted is selected or not:

  • If devices register to Pexip Infinity we recommend using two gateway rules: one higher-priority rule to specifically handle registered devices, and one lower-priority rule to handle any device (registered and non-registered).
  • If you are using third-party call control systems you also may want to use different rules to distinguish between calls arriving at Conferencing Nodes in different locations.

To configure each rule:

1. Go to Services > Call routing and select Add Call Routing Rule.

2. Configure the following fields (leave all other fields with default values or as required for your specific deployment):

   Option	Description
   Name	The name you will use to refer to this rule.
   Priority	Assign the priority for this rule. If you are creating multiple rules where one rule has Match incoming calls from registered devices only selected, and other rules do not have this option selected, then ensure that the rules that do have Match incoming calls from registered devices only selected have a higher priority (lower number) than those rules where it is not selected (to avoid the call matching first against the "not selected" rule if all of the other rule settings are the same).
   Incoming gateway calls	Ensure this option is selected.
   Outgoing calls from a conference	Leave unselected.
   Calls being handled in location	Applies the rule only if the incoming call is being handled by a Conferencing Node in the selected location. To apply the rule regardless of the location, select Any Location.
   Match incoming calls from registered devices only	If devices register to Pexip Infinity, we recommend using two gateway rules: one higher-priority rule to specifically handle registered devices, and one lower-priority rule to handle all devices (registered and non-registered). Select this option if you want the rule to apply only to calls received from devices that are registered to Pexip Infinity. Leave this option unselected if you want the rule to apply regardless of whether the device is registered to Pexip Infinity.
   Match Infinity Connect (WebRTC / RTMP) Match SIP Match Lync / Skype for Business (MS-SIP) Match H.323	Select one or more of Match Infinity Connect (WebRTC / RTMP), Match SIP, Match Lync / Skype for Business (MS-SIP) and Match H.323 as appropriate, depending on which types of systems/protocols you want to offer interoperability into Hangouts Meet.
   Match against full alias URI	Leave unselected.
   Destination alias regex match	Enter a regular expression that will match the calls to be sent to a Hangouts Meet conference. For example, to match an alias in the form <meeting code> or <meeting code>@example.com, where the meeting code has a prefix of 8 and is followed by a further 3-9 digits, you could use: (8\d{3,9})($|(@example\.com$))
   Destination alias regex replace string	If required, enter the regular expression string to transform the originally dialed (matched) alias into the meeting code to use to place the call into the Hangouts Meet conference. If you do not need to change the alias, leave this field blank. When used with the example Destination alias regex match shown above you would use: \1 which would extract just the <meeting code> element of the alias.
   Call capability	To support incoming calls via SIP, H.323 and WebRTC/RTMP, Same as incoming call is recommended as this makes the most efficient use of Pexip Infinity resources. If you also want to support calls from Skype for Business / Lync, then you should select Main video + presentation instead to ensure that any SfB/Lync participants are able to escalate from audio-only to a video call after joining the conference (alternatively you can configure a separate rule just for matching incoming calls from Skype for Business / Lync and set that rule to use Main video + presentation).
   Theme	If required, assign a customized theme to this rule (which will then be used for callers that use this rule to gateway into Hangouts Meet). For example, the theme could use alternative labels on some of the splash screens that are displayed when connecting to a conference.
   Call target	Select Google Hangouts Meet meeting.
   Outgoing location	If required, you can ensure that the outgoing call to the Hangouts Meet conference is handled by a Conferencing Node in a specific location. If an outgoing location is not specified, the call is placed from a Conferencing Node in the ingress location (the same location as the Conferencing Node that is handling the incoming call).
   Access token	Select the name of the access token to use to resolve Google Hangouts Meet codes. You should select either a trusted or untrusted type of token, depending on whether you want to enable the device to be automatically admitted into the Google Hangouts Meet conference (subject to also being a trusted endpoint from Pexip Infinity's perspective i.e. if the rule also has Treat as trusted enabled). Typically, you will use a trusted token if Treat as trusted is selected, and an untrusted token if Treat as trusted is not selected. See Enabling access and admitting external participants into Hangouts Meet conferences for more information.
   Treat as trusted	Select Treat as trusted if you want Hangouts Meet to treat the devices routed via this rule as part of the target organization for trust purposes. Typically you will select this option if the rule is handling devices that are trusted from Pexip Infinity's perspective, for example, you could treat the device as trusted if the caller is coming from a specific location, or if the device is registered to Pexip Infinity. This setting is used in conjunction with the Access token setting to control whether the device is automatically admitted into the Hangouts Meet conference.

3. Select Save.
4. If you are creating multiple rules, for example when handling whether a device is registered to Pexip Infinity or not, return to step 1 and create the next rule.

Using the direct gateway service

After the Call Routing Rule has been configured, third-party systems and devices can now dial an alias that matches your specified pattern (e.g. 812345 or 812345@example.com) to be routed directly into the appropriate Hangouts Meet conference (in this example the conference with a meeting code of 812345).

To route calls to Hangouts Meet conferences via a Virtual Reception (IVR gateway) you need:

• A Virtual Reception configured specifically to handle Hangouts Meet conferences.
• A Call Routing Rule to route the calls handled by the Virtual Reception into the relevant Hangouts Meet conference. Typically you would configure the Virtual Reception and Call Routing Rule patterns so that the same rule can also support direct routing as described above.

The Virtual Reception requests the caller to enter the Hangouts Meet meeting code which it then sends to Hangouts Meet for verification. You can then optionally transform the meeting code to meet any dial plan requirements, before the Pexip Distributed Gateway then matches the (optionally transformed) meeting code and routes the caller to the appropriate Hangouts Meet conference.

To configure the Virtual Reception:

1. Go to Services > Virtual Receptions and select Add Virtual Reception.

2. Configure the following fields (leave all other fields with default values or as required for your specific deployment):

   Option	Description
   Name	The name you will use to refer to this Virtual Reception, for example "Google Hangouts Meet IVR gateway".
   Theme	If required, assign a customized theme to this Virtual Reception to brand it as the gateway to Hangouts Meet conferences, for example by customizing the voice prompts or changing the appearance of the Virtual Reception splash screen.
   Virtual Reception type	Select Google Hangouts Meet.
   Access token	Select the name of the access token to use to resolve Google Hangouts Meet codes. When configuring a Virtual Reception it does not matter if you use a trusted or untrusted access token.
   Lookup location	If specified, a Conferencing Node in this system location will perform the service lookup. If a location is not specified, the IVR ingress node will perform the lookup.
   Post-lookup regex match	This is an optional field. It is typically used in conjunction with the Post-lookup regex replace string to transform the meeting code entered into the Virtual Reception into a distinct alias pattern that will match a Call Routing Rule that is configured to route calls into Google Hangouts Meet conferences. Note that this match and transform occurs after the meeting code entered by the user has been sent to Hangouts Meet for verification. In most cases, you would typically set the regex match to: (.*) which matches everything entered into the Virtual Reception.
   Post lookup regex replace string	This may be used in conjunction with the Post-lookup regex match field to transform the meeting code entered by the caller. In our example, setting it to: \1 will simply pass on the entered meeting code unchanged. This will then typically work in conjunction with the Call Routing Rule that you configured above for direct routing (which matches calls placed to aliases prefixed with 8 in our example) and then directs the call to Google Hangouts Meet.
   Alias	Enter the alias that users will dial to use this Virtual Reception to place calls into Hangouts Meet conferences, for example gmeet@example.com.

3. Select Save.

To configure the associated Call Routing Rule:

• Configure the Call Routing Rule as described above for direct routing.
• If you want to use a different rule for routing via a Virtual Reception than the rule you are using for direct routing (e.g. because you want to limit the supported incoming call protocols, or use a different outgoing location for calls placed via the Virtual Reception), then follow the same principles as the direct routing rule, but use a different alias pattern in your Virtual Reception's Post-lookup regex replace string and your rule's Destination alias regex match string.

Using the Hangouts Meet IVR gateway service

After the Virtual Reception and Call Routing Rule have been configured, third-party systems and devices can now dial the alias of the Virtual Reception (e.g. gmeet@example.com) and then, when prompted by the IVR service, enter the meeting code of the Hangouts Meet conference they want to join.

The Pexip Distributed Gateway will then route the call into the appropriate Hangouts Meet conference.