> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhomie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Email Tool

> Let your assistant send emails during a chat from a verified sender.

The email tool lets the assistant send emails on your behalf during a conversation — for example, to forward a shopper's request to your team or send a confirmation back to the shopper. Emails go out from a sender you have set up, so they come from your brand instead of a generic address.

<Note>
  Before the email tool can send, set up a sender: either the **default sender**, or your own verified email domain and sender profile. See [Settings › Email Domains](/en/user-guide/settings/email-domains). A verified own domain keeps emails on-brand and improves deliverability.
</Note>

## Set up the email tool

<Steps>
  <Step title="Create the tool">
    On the platform, go to **Tools** and select **New tool**. Choose **Email**, or start from a template such as *Handover to support* or *Lead capture* and adjust it.
  </Step>

  <Step title="Name and describe the tool">
    Under **Configuration**, give the tool a clear **Name** and a **Description** of when the assistant should send the email. A specific description helps the assistant decide when the tool is relevant.
  </Step>

  <Step title="Define the parameters (optional)">
    Under **Parameters**, add any values the assistant should collect for the email — for example a customer email address or a summary of the request. The assistant fills these in from the conversation.
  </Step>

  <Step title="Configure the emails">
    Under **Emails**, add one or more messages. For each, set the **Recipient** (a fixed address, or **From parameter** to use a value the assistant collected), the **Subject**, and the message text. Subject and message can include `{parameter_name}` placeholders that are filled in when the email is sent. Optional parameter recipients are skipped when left empty.
  </Step>

  <Step title="Choose the sender">
    Under **Sending**, select the sender profile that emails are sent from.
  </Step>

  <Step title="Test it">
    Select **Test tool**, enter sample values, and run it.

    <Check>
      The test email is delivered and shows your verified sender name and address.
    </Check>

    <Warning>
      A test sends a real email to the configured recipients. Use addresses you control when testing.
    </Warning>
  </Step>

  <Step title="Assign it to an assistant">
    Save the tool, then open the assistant that should use it and assign the tool from its **Tools**.
  </Step>
</Steps>

## How the assistant uses it

Once assigned, the assistant sends an email when the conversation calls for it — for instance, when a shopper asks to be contacted or wants something forwarded to your team. It composes the message from your templates, sends it from your sender, and continues the chat.

<Warning>
  The email tool can send messages automatically during live chats. Use a sender you control, and verify your domain so messages are delivered and clearly come from your brand.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Email domains" icon="at" href="/en/user-guide/settings/email-domains">
    Add and verify the domain emails are sent from.
  </Card>

  <Card title="HTTP Tool" icon="wrench" href="/en/user-guide/tools/custom-tools">
    Add HTTP request tools for live data and actions.
  </Card>
</CardGroup>