Skip to main content

Creating an Email Channel in Whippy

Set up an email channel so your team can send and receive emails from a shared inbox in Whippy.

Maria Cairns avatar
Written by Maria Cairns
Updated today

Why it matters

Email channels let your team manage customer emails from one shared place instead of personal inboxes. Each email channel uses a specific sender address and can be shared by multiple users, which keeps communication centralised, consistent, and easier to route and report on.

Key Concepts

Channel: A shared inbox where customer conversations are managed. A channel can be tied to a phone number, email address, or other messaging source.

Email Channel: A channel that uses an email address to send and receive email communication with customers.

Communication Provider: The email service configuration used for this channel. You can use the default Whippy provider or a custom provider.

Channel Sender (Email Address): The email address that appears in the “From” field when sending messages from this channel.

Business Address and Google Place ID: Required location fields for a channel. The business address can be matched to Google Maps so the Google Place ID is populated. Both are required to proceed when creating a channel.

Default vs Custom Provider:

  • Default: Uses Whippy’s built-in email provider and default domain.

  • Custom: Uses your own email provider with custom API credentials and domain.

Step-by-Step: Create an email channel

  1. Open the Channels settings.

    Go to Organisation Settings and click Channels to see all channels for your organisation.

  2. Start creating a new channel.

    Click the Add channel button in the top right corner to open the five step setup flow.

  3. Step 1 of 5: Enter basic channel details.

    • In the Channel name field, enter a clear name, for example “Support Email” or “Sales Email”.

    • Click the emoji picker to select an icon for this channel.

    • Add a short Description that explains what this email channel is used for.

    • Enter the Business address for this channel.

    • Select the correct address from the Google suggestions so the Google Place ID is automatically populated, or paste the Google Place ID if you already have it.

    • Both Business address and Google Place ID must be set to move forward. Click Next when complete.

  4. Step 2 of 5: Select the channel type.

    • On the channel type screen, select Email.

    • Click Next to continue.

  5. Step 3 of 5: Select the communication provider.

    In this step, you decide whether to use the default email provider or a custom configuration.

    Option A: Use the default provider

    • In Communication provider, select Default.

    • No extra fields are required.

    • Click Next to continue.

    Option B: Use a custom provider

    • In Communication provider, select Custom.

    • Fill in the custom provider fields:

      • Base domain

      • API key

      • Email (sender email for the provider)

      • Webhook signing key

    • After all fields are complete, click Next.

  6. Step 4 of 5: Configure the channel sender (email address).

    If you selected the default provider:

    1. In the Sending email address section, edit the first part of the address (before the @).

    2. The domain field is pre-populated with the default Whippy email domain shown in your workspace.

    3. If needed, choose a different domain from the Domain dropdown.

    4. Confirm that the full sender address looks correct.

    If you selected a custom provider:

    1. In the Sending email address field, enter the entire email address, including the domain.

    2. No domain is pre-populated when using a custom provider.

    3. Make sure the address matches your external email provider configuration.

    When the sender address is correct, click Next.

  7. Step 5 of 5: Review and create the email channel.

    • Review the summary of your new email channel, which includes:

      • Channel name

      • Symbol (emoji)

      • Description

      • Channel address

      • Sender email address

    • Check that the sender email address is correct, especially the domain.

    • Click Complete to create the email channel.

  8. Confirm the email channel in the list.

    After saving, you return to the Channels list. The new email channel appears with its name, emoji, description, sender address, and last updated information.

Tips and Best Practices

  • Use a descriptive channel name that matches how your teams work, for example “Support Email”, “Onboarding Email”, or a specific region.

  • Keep the description short and clear so other admins understand the channel’s purpose at a glance.

  • Make sure the business address matches a real address in Google so the Google Place ID is easy to populate.

  • Decide whether you need Default or Custom provider before starting. Use Default if you do not need your own SMTP or email infrastructure.

  • When using a custom provider, gather the base domain, API key, email, and webhook signing key in advance so you do not block the flow.

  • Double check the sender email address on the review step. Changing sender configuration later may require editing the channel configuration instead of the creation flow.

  • After creating the channel, use the Business hours, Autoresponses, Settings, and Users tabs to tailor how the email channel behaves and who can use it.

Troubleshooting

Issue

Possible Cause

Fix

Cannot click Next on Step 1

Required fields are missing

Make sure Channel name, Business address, and Google Place ID are filled. Select the address from the Google suggestion so the Place ID is set.

Step 3 requires API details but I expected to use the default provider

Custom was selected instead of Default

Change Communication provider to Default, then click Next.

Sender email domain is pre-filled and cannot be typed

Default provider is selected and the domain uses Whippy’s configured domain list

Use the dropdown to select a different allowed domain. If you need a completely different domain, switch to a Custom provider and configure it there.

No domain appears in the sender field

Custom provider is selected

Enter the full email address including the domain, for example support@yourdomain.com.

Sender email address is wrong after creation

Sender configuration was not reviewed on Step 5

Edit the channel from Organisation Settings → Channels, open the Configuration tab, and update the sender settings as allowed by your provider setup.

Did this answer your question?