Settings

Here is a full list of available settings, and their default values, for RapidSMS and its contrib apps.

 

DEFAULT_RESPONSE

App:rapidsms.contrib.default
Default:'Sorry, %(project_name)s coud not understand your message.'

The default response to an IncomingMessage that is not handled by any other application. To include PROJECT_NAME, use '%(project_name)s' in the string.

 

EXCLUDED_HANDLERS

App:rapidsms.contrib.handlers
Default:[]

The rapidsms.contrib.handlers application will not load any handler in a module that is in this list. The module name of each handler is compared to the value in this list using prefix matching. For more information, see Handler Discovery.

 

INSTALLED_BACKENDS

Default:not set

This setting is a dictionary that allows you to configure backends for use in your project. There is no default value as the needs of individual projects vary widely. This setting mimics the structure of the Django DATABASES setting, with the following general format:

INSTALLED_BACKENDS = {
    'backend1_name': {
        'ENGINE': 'path.to.backend1',
    },
    'backend2_name': {
        'ENGINE': 'path.to.backend2',
    },
}

Each backend dictionary requires only the ‘ENGINE’ key, which defines the Python path to the backend. Other key-value pairs can be used to configure backend-specific options.

Example configuration:

INSTALLED_BACKENDS = {
    "message_tester": {
        "ENGINE": "rapidsms.contrib.httptester.backend",
    },
}
 

INSTALLED_HANDLERS

App:rapidsms.contrib.handlers
Default:None

If this setting is not None, the rapidsms.contrib.handlers application will only load handlers in modules that are in this list. The module name of each handler is compared to each value in this list using prefix matching. For more information see Handler Discovery.

 

PROJECT_NAME

Default:'RapidSMS'

The name of your project. This is used by some applications such as rapidsms.contrib.default to customize message responses.

 

RAPIDSMS_HANDLERS_EXCLUDE_APPS

App:rapidsms.contrib.handlers
Default:[]

The rapidsms.contrib.handlers application will not load handlers from any Django app included in this list. For more information see Handler Discovery.

 

RAPIDSMS_ROUTER

New in version 0.10.0: Please, see the release notes

Default:'rapidsms.router.blocking.BlockingRouter'

The router is used to handle incoming and outgoing messages. For the list of available routers see RapidSMS Routers.

Previous topic

Frequently Asked Questions

This Page