Documentation / Email Channel

Email Channel

Updated July 18, 2026

Agent Builder Connectors and Channels screen showing Email configuration
Configure the Email channel in Connectors & Channels

The Email channel turns your AI agents into correspondents: customers write to an address like [email protected] and an agent answers by email — no helpdesk software in between. It also powers human handoff, forwarding a chat transcript to your team when an agent reaches the limits of what it can do. The Email channel is part of Agent Builder Pro.

Prerequisites

  • Agent Builder Pro installed and activated
  • Working outgoing mail on your WordPress site (an SMTP plugin such as WP Mail SMTP is strongly recommended)
  • For inbound email: a mail relay that can POST a parsed message to a webhook (e.g. your provider’s inbound-parse feature)

Setup

1. Configure the channel

  1. In your WordPress admin go to Agent Builder Pro → Connectors & Channels → Channels and open the Email section.
  2. Set the From Email and From Name your agents reply with, and the Recipient address that receives human-handoff transcripts.
  3. Pick the Default Agent for inbound mail.
  4. Save, then send a test message to confirm delivery.

2. Enable two-way email (optional)

Outbound replies work out of the box. For a full round trip — a customer emails in, an agent answers — point your mail relay’s inbound webhook at:

  • URL: https://your-site.com/wp-json/agentic/v1/email/inbound
  • Secret: set an Inbound Secret in the channel settings; every relay request is HMAC-signed with it, the same trust model as the WhatsApp channel.

Expected result

When a website chat needs a human, the full transcript lands in your recipient inbox so you can pick up where the AI left off. With inbound enabled, an email to your support address gets an agent reply within a minute, and the exchange is logged in Agent Builder → Activity like any other conversation. Inbound mail is rate-limited per sender to prevent mail-loop abuse.

Troubleshooting

  • Test email never arrives — WordPress’s default mailer is often silently dropped; install an SMTP plugin and verify delivery there first.
  • Replies land in spam — set up SPF/DKIM for your sending domain, and send from an address on that domain.
  • Inbound webhook rejected — the Inbound Secret in Agent Builder must match the secret your relay signs with; check your relay’s delivery log for the exact failure.

Related

Browse all documentation →