Jump to: navigation, search

External Services Protocol

Also known as an ESP. Used by Interaction Server to communicate with servers that perform a specific service, when it is requested to do so. Such servers are called ESP servers. Classification Server is an ESP server, as is E-mail Server Java (when it generates an acknowledgment or autoresponse; when E-mail Server Java processes incoming or outgoing e-mail messages, it is a media server). You can create custom ESP servers by using the Genesys Open Media Platform SDK.



Glossary

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Checking if a Contact Uses WhatsApp

This page describes how to verify whether a contact uses WhatsApp. Refer to the WhatsApp developer documentation for more information on how to use this feature.

Sending an ESP request

To verify whether a contact uses WhatsApp, your strategy must send an External Services Protocol (ESP) request that specifies the following:

  • AppType—Enter the value 171, which is the application type for DMS, or select SocialMS in the ESP object in Interaction Routing Designer (IRD). This setting is not required if AppName is set in the request.
  • AppName—Specify the name of the DMS Application, as defined in Configuration Sever.
  • ServiceMessaging
  • MethodValidateContact

Request parameters

Parameter Type Value Description
_umsChannel string The DMS channel name Specify the DMS channel name for WhatsApp. You can omit this parameter if only one channel is configured in your environment.
Id string Contact phone number Specify the contact's phone number. You can use any phone number format (for example, (555)555-5555 or 15555555555).

Response parameters

Parameter Type Value Description
Id string Normalized contact phone number If the contact was confirmed by WhatsApp, the value is the contact's normalized phone number. Otherwise, an empty string is returned.

Error responses

Error Code Message
900 "%s %s" (generic error)
901 "%s connection with %s failed"
701 "Request is invalid: Service or Method name was not specified..."
902 "%s unknown %s" (might be "unknown service", "unknown method", "unknown service or method" or similar)
904 "%s incorrect %s"
920 "%s failed to execute request %s"
This page was last modified on April 19, 2019, at 13:27.

Feedback

Comment on this article:

blog comments powered by Disqus