My Communications (2)

Getting Started — Usage Guide

Step 1 (registering an XMPP account) is on the main My Communications page. Back to My Communications

2. Set Your Language

Add the translator bot as a contact, then send it a message to set your preferred language:

translator@ngportal.com

Any ISO 639-1 language code your translation model supports will work. Common choices:

register:yo  (Yoruba)
register:fr  (French)
register:sw  (Swahili)
register:af  (Afrikaans)
register:xh  (Xhosa)
register:ar  (Arabic)
register:ak  (Twi)
register:ee  (Ewe)
register:zu  (Zulu)
register:ha  (Hausa)
register:ig  (Igbo)

3. Chat Translation

In any MUC or 1:1 chat, messages are auto-translated to your language. To correct a translation, paste the original message back with your correction:

4. Email Translation

Incoming emails are auto-translated. Access your email via:

5. WhatsApp Bridge

Link your WhatsApp account via slidge-whatsapp:

6. Telegram Bridge

Link your Telegram account via slidge-telegram:

Bot Commands Reference

CommandDescription
register:yoSet language to Yoruba
register:frSet language to French
register:swSet language to Swahili
register:afSet language to Afrikaans
register:xhSet language to Xhosa
register:arSet language to Arabic
wa-registerRegister WhatsApp bridge
wa-statusCheck WhatsApp bridge status
wa-helpWhatsApp bridge help
unregisterStop translating your messages
statusShow your language and settings
muc:listList group rooms the bot has joined
muc:join:ROOMAdd the bot to a group room
mode:autoHandle voice and images automatically
mode:sttTranscribe and translate voice notes
mode:ttsReply with spoken audio
mode:imageRead and translate text in photos
modelsList available voices and languages
voice-helpShow the voice settings commands
voice-statusShow your current voice settings
voice-set lang:CODESet the spoken language
helpShow all commands

7. Voice Notes & Images

The bot also understands audio and pictures. Set what it should do with incoming media:

mode:auto    (detect automatically)
mode:stt     (transcribe and translate voice notes)
mode:tts     (reply with spoken audio)
mode:image   (read and translate text in photos)

Send voice-help for the voice settings, or models to list the available voices and languages. To change a setting:

voice-set lang:yo
voice-set voice:ID
voice-set model:ID

Use voice-status to see your current choices.

8. Group Chats

The bot can translate inside group rooms too:

muc:list           (show rooms the bot is in)
muc:join:ROOM      (add the bot to a room)

9. Email Translation Corrections

To correct an email translation in SnappyMail or Roundcube:

10. Chat Translation Corrections

In XMPP MUC or 1:1 chats, reply to a translated message with:

The bot will update the translation memory for future messages.