Welcome Symphony Developer!

Let's change the way we work

Development Options

You can integrate the Symphony platform with your systems to drive business processes in the following ways:

  • Chat Bot: Our bots is an automated system user that performs tasks and exists inside of an application running within your own infrastructure. These chat bots leverage our REST API: The Symphony REST API allows you to access all pod and agent functionality in your client applications through a rich set of endpoints. See REST API Architecture for an overview. Symphony offers several SDKs in your preferred language for you to get started:

  • Extension App: The Client Extension API is a JavaScript library that allows you to build standalone web apps which are embedded in the Symphony user interface. See Overview of Extension Applications for an overview. You can also build applications that leverage "On-Behalf-Of" technology that enables your application to act on behalf of users.

  • Embedded Chat Module: This JavaScript embedded chat resource allows you to embed chat room and instant message modules into other applications that support web views.

API Caller

Throughout the documentation, the terms bot process and API caller denote the entity that invokes Symphony APIs.

Choosing a Development Path

The following flowchart shows how to choose a development option depending on your business needs. Start at the far left at "Do you want to embed it into Symphony?" and then continue answering the questions. The rectangles highlighted in orange represent some of the solutions you can build with the development facilities listed above.

Basic Terminology

The following terms are used throughout the documentation:

  • Pod: A set of dedicated infrastructure in the cloud that Symphony operates on behalf of each customer
  • Key Manager: A service that stores and manages customer-specific encryption keys for Symphony content
  • API Agent: A service that encrypts and decrypts message payloads sent and received by an API caller, such that the caller does not need to implement content encryption. The agent connects to the pod over the Internet.
  • Bot: To Symphony users, a bot is a user that can perform automated tasks. To a Symphony developer, a bot is an application that connects to Symphony using a service account.
  • IM (instant message): A conversation between two users.
  • MIM (multi-party instant message): A conversation between more than two users.
  • Stream: Also known as a conversation. Streams can either be IMs, MIMs or rooms.
  • OBO (on behalf of): Actions that are performed by a bot on behalf of a Symphony end-user.


Welcome Symphony Developer!


Let's change the way we work

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.