Skip to main content

Setting up a Service

A Service is a machine which will receive messages from Parley about certain events. This Service is defined by an url which Parley will use to send the messages to.

Adding a service

If you want to create your own Service, or enable Proactive messaging for your parley account you can contact support@parley.nu.

The information you need to supply is the following:

  • Callback url: The url we will send messages to. This url/endpoint must be able to receive POST messages.
  • Callback headers: Any headers that we should add to the request. For example you can add an "Authorization" header with some token inside for handling authorizations on your endpoint.
  • Account identification: This tells us for which account you want to connect this Service.
Multiple services

You can have multiple Services connected to a Parley account.
See Handover protocol for an example.

In the Parley dashboard you can find out which Service(s) are connected to your Parley account by navigating to the following menu: Settings -> Service Information. In this overview you will see which Service(s) is(are) connected. You can also see if the Service is marked as default service. This setting defines whether the Service should be the default "owner" of any new users. You can only change this if you have 2 or more Services connected.

warning

Please note that only one service can be marked as default service.

danger

For Services that are supposed to only "listen" for messages/events we suggest you to not enable them as a default service. If the Service has no ability to respond to Customer messages or is not able to appoint another Service as the owner, your customers would not be able to reach you.