summary refs log tree commit diff
path: root/docs/application_services.rst
blob: 07236e62aed3a8dab0c00e88d4e3d9078c2104bd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Registering an Application Service
==================================

The registration of new application services is implementation dependent. In
synapse you need to create a new configuration file for you AS and add it to
the list of AS's specified under ``app_service_config_files`` synapse
config option.

The format of the AS configuration file is as follows::

    url: <base url of AS>
    as_token: <token AS will add to requests to HS>
    hs_token: <token HS will ad to requests to AS>
    sender_localpart: <localpart of AS user>
    namespaces:
      users:  # List of users we're interested in
        - exclusive: <bool>
          regex: <regex>
        - ...
      aliases: []  # List of aliases we're interested in
      rooms: [] # List of room ids we're interested in

See the spec_ for further details on how application services work.

.. _spec: https://github.com/matrix-org/matrix-doc/blob/master/specification/25_application_service_api.rst#application-service-api