Create xmpp.rst

source/applications/xmpp.rst

@@ -0,0 +1,152 @@
+############
+XMPP Manager
+############
+
+|
+
+.. image:: ../_static/images/fusionpbx_xmpp.jpg
+        :scale: 85%
+
+|
+
+| XMPP Manager is an optional menu item.  In order to have the option for XMPP Manager there are a few step to take to enble XMPP.
+
+|
+
+.. image:: ../_static/images/fusionpbx_xmpp1.jpg
+        :scale: 85%
+
+|
+
+**XMPP Profile**
+
+| FusionPBX menu.
+
+| Accounts -> XMPP manager.
+
+| Click the
+
+.. image:: ../_static/images/plus.png
+        :scale: 75%
+        
+| on the right to create a profile.         
+
+| In this example we will setup Google Talk and by creating a profile called gtalk. 
+
+::
+
+ Profile Name: gtalk
+ Username: [email protected] (use your account)
+ Password: use the correct password
+ Auto-Login: yes
+ XMPP Server: talk.google.com
+
+|
+
+.. image:: ../_static/images/fusionpbx_xmpp2.jpg
+        :scale: 85%
+
+
+| Two approaches can be used for the next part.
+
+| **Option 1.**
+
+| Lets say my gmail number was 13051231234. This approach will send the inbound calls to the inbound routes with a destination number that is the default extension number that is set.
+
+::
+
+ Default extension: 13051231234
+ Advanced -> Context: public
+
+
+| **Option 2.**
+
+| On a single tenant system. This will send the call to extension 1001 in the default context.
+
+::
+
+ Default extension: 1001
+ Advanced -> Context: default
+
+| **Option 3.**
+
+| On a single tenant system. This will send the call to extension 1001 in the multi-tenant domain name.
+
+::
+
+ Default extension: 1001
+ Advanced -> Context: your.domain.com
+
+| Save the settings and restart the module. Restart the 'XMPP' module from Advanced -> Modules page. 
+| Go back to Accounts -> XMPP if the status says **'AUTHORIZED'** then you are ready to go.
+
+| **Note** If you are not getting AUTHORIZED you might need to goto the google account settings and choose "Allow less secure apps: ON" under the Sign-in & security section.
+
+|
+
+.. image:: ../_static/images/fusionpbx_xmpp5.jpg
+        :scale: 85%
+
+|
+
+| **Outbound Routes**
+
+| For this example we will use 11 digit dialing.
+
+::
+
+ Gateway: XMPP
+ Dialplan Expression: 11 digits
+ Description: Google Talk
+ Press Save
+
+| If your XMPP profile is named something other than gtalk edit the outbound route you just created.
+| Bridge statement should look like: dingaling/gtalk/[email protected] replace gtalk with the profile name you chose and then save it.
+
+|
+
+Enable XMPP
+===========
+
+
+|
+
+| XMPP manager is used to configure client side XMPP profiles. It can be used as a client to register to make and receive call with Google Talk or other XMPP servers.
+
+|
+
+| **GIT Manually add XMPP**
+|
+| After version 3.8 XMPP is optional.  To add XMPP do the following
+
+| Goto command line
+
+::
+
+ cd /tmp
+ git clone https://github.com/fusionpbx/fusionpbx-apps.git 
+ cd fusionpbx-apps/
+ mv xmpp/ /var/www/fusionpbx/app/
+ cd /var/www/fusionpbx/app
+ chown www-data:www-data -R xmpp/
+
+
+
+Goto Fusionpbx GUI
+
+| Goto the GUI and click advanced > menu manager > edit icon > click "Restore Defaults" at top right
+|
+
+| Then goto Advanced > Upgrade click Schema, Data Types, and Permission Defaults then click execute
+
+|
+| Click status > sip status > Flush Memcache
+
+|
+| Log out then back in
+
+|
+| You should now have XMPP Manager under Accounts
+
+|
+