Skip to content

res_xmpp: XMPP Messaging

This configuration documentation is for functionality provided by res_xmpp.

Configuration File: xmpp.conf

[global]: Global configuration settings

Since

12.0.0

Configuration Option Reference

Option Name Type Default Value Regular Expression Description Since
auth_policy Whether to automatically accept or deny users' subscription requests 11.0.0
autoprune Auto-remove users from buddy list. 11.0.0
autoregister Auto-register users from buddy list 11.0.0
collection_nodes Enable support for XEP-0248 for use with distributed device state 11.0.0
debug Enable/disable XMPP message debugging 11.0.0
pubsub_autocreate Whether or not the PubSub server supports/is using auto-create for nodes 11.0.0

Configuration Option Descriptions

autoprune

Since: 11.0.0

Auto-remove users from buddy list. Depending on the setup (e.g., using your personal Gtalk account for a test) this could cause loss of the contact list.

[client]: Configuration options for an XMPP client

Since

12.0.0

Configuration Option Reference

Option Name Type Default Value Regular Expression Description Since
auth_policy Whether to automatically accept or deny users' subscription requests 11.18.0, 13.4.0
autoprune Auto-remove users from buddy list. 11.18.0, 13.4.0
autoregister Auto-register users bfrom buddy list 11.18.0, 13.4.0
buddy Manual addition of buddy to list 11.0.0
context Dialplan context to send incoming messages to 11.0.0
debug Enable debugging 11.0.0
distribute_events Whether or not to distribute events using this connection 11.0.0
forceoldssl Force the use of old-style SSL for the connection 11.0.0
keepalive If enabled, periodically send an XMPP message from this client with an empty message 11.0.0
oauth_clientid Google OAuth 2.0 application's client id 13.18.0, 14.7.0, 15.1.0
oauth_secret Google OAuth 2.0 application's secret 13.18.0, 14.7.0, 15.1.0
port XMPP server port 11.0.0
priority XMPP resource priority 11.0.0
pubsub_node Node for publishing events via PubSub 11.0.0
refresh_token Google OAuth 2.0 refresh token 13.18.0, 14.7.0, 15.1.0
secret XMPP password 11.0.0
sendtodialplan Send incoming messages into the dialplan 11.0.0
serverhost Route to server, e.g. talk.google.com 11.0.0
status Default XMPP status for the client 11.0.0
statusmessage Custom status message 11.0.0
timeout Timeout in seconds to hold incoming messages 11.0.0
type Connection is either a client or a component 11.0.0
username XMPP username with optional resource 11.0.0
usesasl Whether to use SASL for the connection or not 11.0.0
usetls Whether to use TLS for the connection or not 11.0.0

Configuration Option Descriptions

autoprune

Since: 11.18.0, 13.4.0

Auto-remove users from buddy list. Depending on the setup (e.g., using your personal Gtalk account for a test) this could cause loss of the contact list.

buddy

Since: 11.0.0

Manual addition of buddy to the buddy list. For distributed events, these buddies are automatically added in the whitelist as 'owners' of the node(s).

status

Since: 11.0.0

Can be one of the following XMPP statuses:

  • chat

  • available

  • away

  • xaway

  • dnd

timeout

Since: 11.0.0

Timeout (in seconds) on the message stack. Messages stored longer than this value will be deleted by Asterisk. This option applies to incoming messages only which are intended to be processed by the 'JABBER_RECEIVE' dialplan function.

Generated Version

This documentation was generated from Asterisk branch 20 using version GIT