Skip to main content
Skip table of contents

Setting up outbound email

Distribution channels are used to define outgoing email settings and to specify the email account to send messages from. You cannot send email in ServiceJourney until at least one distribution channel is configured and enabled. There are two types of mailboxes that can be used with ServiceJourney: SMTP mailboxes and Microsoft 365 accounts. Either of those options need to be provisioned by your organization.

Emails can be sent automatically as part of a business process or manually by a user during their day-to-day work. A copy of all outbound emails and their attachments are saved to either a Case or a Party that they are associated with. 

You can configure multiple email accounts from which to send messages from. This can be used to distinguish between transactional and marketing emails, or to support a multi-brand business. 


Steps to connect your email account

  1. On the top right, navigate to 
    cog
     → Application Studio → ServiceJourney
  2. Once inside Application Studio, navigate to Channel Setup → Distribution Channels → Customer Service 1 → Edit
  3. Select the Protocol you wish to use to send emails out from your organizations. Fill in the fields, as shown below.

    Graph API settings

    Protocol: Office365 Graph

    E-mail Address: @@SJ_GRAPHAPI_EMAIL_ADDRESS@@

    Application (Client ID): @@SJ_GRAPHAPI_CLIENT_ID@@

    Directory (Tenant ID): @@SJ_GRAPHAPI_TENANT_ID@@

    Authentication: Secret Key or Certificate

    Client Secret Key: @@SJ_GRAPHAPI_CLIENT_SECRET_KEY@@

    Client Certificate Body: upload the certificate if you select "Certificate" 

    Client Certificate Password: @@SJ_GRAPHAPI_CERTIFICATE_PASSWORD@@ if you select "Certificate" 

    SMTP settings

    Protocol: SMTP

    SMTP Server: @@SJ_SMTP_SERVER@@

    SMTP Username: @@SJ_SMTP_USERNAME@@

    SMTP Password: @@SJ_SMTP_PASSWORD@@

    Port: @@SJ_SMTP_PORT@@

  4. Click Save

  5. If you changed anything in Channel Setup → Distribution Channels → Customer Service 1 page, go to Deployment Management → Deploy and deploy the solution
  6. Navigate to Solution Preferences → Environment Variables

  7. Click on the 
     icon next to appropriate values and set your email account info
  8. When done, click on the Update Context button at the top
  9. On the top right, navigate to 
     → ServiceJourney
  10. On the left, navigate to
     → Case Management → Admin Settings → Distribution Channels
  11. Click the Sync button
  12. Click on the 
    cog
    next to Customer Service 1 and select Quick Modify
  13. Set the Email From Address and Reply to Email Address to the correct values 

Testing the configuration

  1. On the top right, navigate to 
     → ServiceJourney
  2. On the left, navigate to
     → Setup 
  3. Once inside Setup, navigate to Advanced Setup → Maintenance and ensure the System Variables you configured in Application Studio are correct
  4. Scroll down to Distribution Channels and click on the 
    cog
    next to Customer Service 1 and select Test via Distribution Channel
  5. Fill in your email address and verify that the email has arrived

Business-specific Distribution Channel properties 

Administrators can set several properties that control how email distribution channels are used by agents to communicate with customers.

  1. On the top right, navigate to 
     → ServiceJourney
  2. On the left, navigate to
     → Case Management → Admin Settings → Distribution Channels
  3. Click on the 
    cog
    next to your distribution channel and select Quick Modify

After configuring the outgoing email distribution channel that customers use to communicate with customer service agents, the administrator can set the following email-specific properties.

PropertyDescription
Distribution ChannelSelect the Distribution Channel you configured in Application Studio. 
Email From AddressThe email address will appear in the From field of the email. This is usually the same email address as the one set in the Environment Settings in Application Studio.
Reply-To Email AddressThe email address to which a Reply or a Reply All gets sent to when a customer responds to an email. This is usually the same as the "Email From Address", but doesn't have to be. For example, you may send an email from noreply@example.com but want customers to respond to a support@example.com address. 
Show in Suggested FromChecking this box will allow a customer service agent to choose this Distribution Channel when sending an email to a customer. For example, you may want the agent to be able to choose a specific brand from which to respond to a customer.
Use by defaultChecking this box will pre-select this Distribution Channel in the From field when customer service agents begin writing an email to a customer.
Search QueueAssign a queue name to this distribution channel

Related content

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.