Jump to: navigation, search

Chat account in Pidgin

Configuring Pidgin

Pidgin is a chat program which lets you log in to accounts on multiple chat networks simultaneously. Pidgin is compatible with the Jabber/XMPP chat network.

This document explains how to configure Pidgin for instant messaging. You need to download and install the Pidgin application on your desktop.

1. If you are using Pidgin for the first time after installation, a Welcome screen displays. Click the Add button which opens Add Account dialog.

Pidgin01.png

2. On the Basic tab provide Login options.

  • Click the Protocol list box to select XMPP protocol.
  • In the Username box, enter username of your account.
  • In the Domain box, enter domain name of your chat server.
  • In the Password box, provide password associated with your account.

Using Mithi SkyConnect trial account?

Use the User Id received in the Welcome Mail
and Password provided by the Mithi team.

Pidgin02.png

3. Click to select the Advanced tab and provide following details.

i) Click the Connection security list box to select
  • Choose the Use encryption if available option if you wish to connect to the server without using SSL, that is using Plaintext Authentication
  • Click to select the Allow plaintext auth over unencrypted streams check-box.
Pidgin41.png
Or
  • Choose the Require Encryption option if you wish to connect the server using SSL, a protocol used to encrypt the data in transit.
Note: You need to confirm with your admin that the SSL service is running on your server and has a valid SSL certificate for your domain.
Pidgin42.png
ii) In the Connect port box, make sure the port number is 5222.
iii) In the Connect server box, enter server name of your Connect Xf server.


iv) Click the Add button which displays Accounts screen showing list of IM accounts configured.
Pidgin42.png
v) On the Accounts screen, click the Close button.
Pidgin004.png

This way, you can configure your account. Now, you can add buddies and chat with them.

Using Pidgin

To start chatting with your friends using Pidgin, you need to add them to your contact list. Also, you can create various groups to organize these contacts group wise.

Adding a contact

Adding a contact to the contact list is a simple procedure. Follow the steps mentioned below to add a contact to your list.

i. Click the Buddies menu and select Add Buddy which opens Add Buddy dialog.
Pidgin04.png
ii. On the Add Buddy dialog, provide
* In the Account list box, make sure your account is selected.
* In the Buddy's username box, enter complete Jabber ID of a person whom you want to chat with.
* In the Alias box, enter the name to be displayed in the buddy list.
* Click the Add buddy to group list box and select a group from the list.
OR
Enter a name for a group you wish to create.
* Click the Add button.
Pidgin006.png
The added contact displays under Buddies group or under the specified group.
Pidgin08.png
Once the user confirms and accepts your invitation, you will receive a notification to authorize the same user.
Pidgin07.png

As you authorize the user, you can view the presence status of the user and you can send text messages to the user.

Pidgin07-1.png

Adding a group

You can organize the contact list by creating various groups and sorting the contacts as per groups.


While adding a contact to the contact list, specify a name for the group to be added in the Add buddy to group box.

Pidgin12.png

OR 1. Click the Buddies menu and then select Add a Group menu item which displays Add Group dialog.

Pidgin09.png

2. On the Add Group dialog, enter a name for a group you wish to create.

3. Click the Add button to create the specified group.

This newly added group displays in the Add buddy to group list box present on the Add Buddy dialog.

Pidgin010.png

You can right-click a required group from the Buddy list and perform various actions on that group.

Pidgin13.png

Using multi user chat(MUC)

Pidgin allows you to create a chat room and have a discussion with a group of colleagues at a time.

Creating a chat room

You can follow the steps mentioned below to add a chat room to the roster.

1. Click the Buddies menu and choose the Add chat menu item.

Pidgin14.png

2. On the Add chat dialog box, provide following information

  • In the Account box, make sure your account is selected.
  • In the Room box, enter the name for a chat room.
  • In the Server box, enter the name of your conference server.
  • In the Handle box, enter your name which you want to be displayed in the chat room.
  • In the Password box, provide the password if you want to make the chat room password protected.
  • In the Alias box, provide an alias to the chat room.
  • Choose the Group from the list box to whom you want to send an invitation.
  • Select the check box if you want to
Join the chat room automatically when created
Remain in chat after window is closed.
Pidgin15.png

3. Click the chat room which displays a message to decide the settings for the chat room.

Pidgin16.png

4. Click the Configure Room button to configure the settings for the chat room.

Pidgin17.png
Select appropriate settings for the chat room.
Pidgin18.png

OR

4. Click the Accept Defaults button to create the room with default settings.

Pidgin17.png

Application creates a chat room with default settings and unlocks the room for chat discussion.

Pidgin25.png


Inviting a contact to the chat room

1. On the chatroom dialog box, click the Conversation menu, and select the Invite menu item.

Pidgin26.png

2. On the Invite buddy in to chat room dialog box,

  • In the Buddy box, enter the email id of the contact you want to invite for chat.
  • In the Message box, enter the message which you want to send as an invitation.
  • Click the Invite button to send an invitation.
Pidgin27.png

3. Application displays alerts when the invitees join the chat room.

Pidgin28.png


Viewing log of the chat room transcripts

You can view the history or log of the chat room discussion.

1. On the chat room dialog box, click the Conversation menu and then theView Log menu item.

Pidgin30.png

A Conversation in the chat room dialog box displays showing all the conversation history of the room.

left'

Joining a chat room for discussion

You can search for the chat room on the server and join the room for discussion. If the room is password protected, you need to provide the same to enter it.

1. On the chat room dialog box, click the Conversation menu and then select the Join a chat menu item.

Pidgin36.png

2. On the Join the chat dialog box, provide

  • In the Account box, enter your email id.
  • In the Room box, provide the exact name of the chat room you want to join.
  • In the Server box, provide name of the chat server.
  • In the Handle box, provide a nick-name for you to be displayed in the chat room.
  • In the Password box, provide the password if the room is password protected.
Pidgin37.png

Or 2. Click the Room List button to view all the chat rooms created on the server.

Pidgin37a.png

3. Select the room from the list and click the Join button to enter the room for discussion.

Pidgin38.png

Troubleshooting / FAQs

What is the server name and host name of my server?

SkyConnect Trial Account User

If you are evaluating the mithiskyconnect.com domain

  • The server name used for accessing any application (POP, IMAP, SMTP, LDAP, XMPP, CalDAV) is mithiskyconnect.com
  • The Host name of the server is mail.mithiskyconnect.com


Hosted Users

For all hosted users

  • The server name is the <domain>
  • The host name is <domain>.mithiskyconnect.com


In Premise Users

Please contact administrator to find out the exact URL.

Note: If you are using Thunderbird/ Pidgin desktop chat application or Monal application on iOS

you dont have to specify host name or server name separately. Specify complete server name URL. Please refer respective documents for details.

Can I use IP address of the server instead of server name URL?

It is not recommended to use IP address of the server. As IP addresses are not permanent and may change in future.

So, please contact to the administrator if you do not know the URL of your server.

Unable to configure your account? Connection Error?

By default, iOS connects to the server over SSL using the default ports.
If the ports are not open for connection and blocked in the Firewall, connection error occurs and configuration fails.

So make sure, you have installed/enabled SSL certificate on your server and ports required for connection to the server are open and not blocked in the firewall.

Please contact your admin to check if there is not a port issue.

Want to connect to the server without using SSL?

Yes, you can connect to the server without using SSL if SSL is configured on it.

Refer the ports required for connection to the server without using SSL.
If the ports are not open for connection and blocked in the Firewall, connection error occurs and configuration fails. So make sure, required ports are open for connection and not blocked in the firewall.

Please contact your admin to check if there is not a port issue.

I have configured my chat account on my mobile as well as desktop. I do miss the chat text on one of the client.

To avoid this, you need to set the priority to 2 for all the clients you are using to access your chat account.