Skip to main content

Channel Configuration

Messaging, Channel Configuration

Turn on the modules and connect the providers that deliver your messages.

Modules (Email and Messaging)​

Two modules control the channels. The Email module manages email providers. The Messaging module manages SMS providers. Open Configuration, System, Modules and select the module.

  1. Select Email or Messaging in the module list.
  2. Check that the module switch is on.
  3. Choose the provider under Email Configurations or Messaging Configurations. The list offers the providers that are installed, for example Mailgun Email or Dialog E–SMS.
  4. Click Save Configuration.

The Messaging module with Dialog E–SMS chosen under Messaging Configurations

Figure 1. The Messaging module switched on, with Dialog E–SMS chosen under Messaging Configurations.

Info: Each module uses one active provider at a time. Switching the provider changes where every new message of that channel is sent. The module settings are also covered in Messaging and Email Settings.

Email Providers (Mailgun, AWS SES, SMTP)​

Open Configuration, System, Plugins and select the provider. Switch the plugin on, fill in its settings and click Save Configuration.

Mailgun​

  1. Select Mailgun Email.
  2. Under From Emails, enter each sender Email Address and Display Name. Use the add button for more senders, and the arrows to change their order.
  3. Enter the Mailgun API Key. It is your Mailgun private key and is hidden after entry.
  4. Enter a Reply To Address if replies should go to a different mailbox.
  5. Copy the Webhook URL into your Mailgun account. Mailgun uses it to report delivery status back to the platform.
  6. Click Save Configuration.

AWS SES and SMTP​

ProviderSettingsFull guide
AWS SES EmailAws SES Region, SES Access Key, SES Secret Key and From Emails.AWS SES Email
SMTP EmailSMTP Host, SMTP Port, Use Secure Connection, Use Authentication, From Emails, Reply to Email and From Display Name.SMTP Email
Mailgun EmailFrom Emails, Mailgun API Key and Reply To Address.Mailgun Email

Important: Treat API keys, secret keys and passwords like passwords. Anyone who has them can send mail as your company.

SMS Providers (Generic SMS, Twilio SMS, Dialog E–SMS)​

Dialog E–SMS​

  1. Select Dialog E–SMS.
  2. Under Sender Masks, enter the sender IDs recipients will see. Use the add button for more than one.
  3. Enter the Username and the Password of your Dialog account.
  4. Click Save Configuration.

Generic SMS and Twilio SMS​

ProviderUse it whenKey settingsFull guide
Generic SMSYour gateway has a web address that accepts a send request.API URL, HTTP Method, Auth Type and the message, sender and recipient mappings.Generic SMS
Twilio SMSYou send through a Twilio account.API URL, Account SID, Auth Token, Call Back URL and From Phone Numbers.Twilio SMS
Dialog E–SMSYou send through Dialog.Sender Masks, Username and Password.Dialog E–SMS

WhatsApp Plugin (WhatsApp Meta API)​

The WhatsApp plugin connects to the Meta WhatsApp Business platform. Create the app in your Meta account first, then copy its values here.

  1. Select WhatsApp and switch the plugin on.
  2. Enter the App ID and the App Secret from the Meta App Dashboard.
  3. Enter the Business ID from Meta Business Manager.
  4. Enter the Access Token. Prefer a permanent token. A temporary token expires and messages then stop.
  5. Enter the Verify Token. It must match the token you gave Meta.
  6. Copy the Webhook URL into the Meta App Dashboard. Meta sends incoming messages and delivery updates to this address.
  7. Click Save Configuration.

Info: The full reference is in WhatsApp.