Setting up Local email piping

Customers with self-hosted LiveAgent installations running on the same server as their mail account have the option to set up local email piping alongside remote email piping.

Customers with cloud-hosted LiveAgent accounts cannot set up local email piping, only remote email piping.

To begin setting up local email piping, navigate in your LiveAgent account to Configuration > Email > Incoming Mail accounts, and click on the "Integrate new email account" button. In the "Email piping" section on the right, click on the "Integrate" button to initiate the email piping account setup.

The same as in the remote email piping setup, you can name your piping email account as desired. It does not have to match your email address. Click on the "Next" button, and on the Ticket configuration screen, choose the department to which emails piped from your mail server should be created as tickets. Also, choose the outgoing email account that will act as the default sender for responses to emails/tickets piped from your mail server.

After clicking the "Finish integration" button, the following confirmation screen with a remote email piping URL will be displayed. To complete the local email piping setup, go to your mail server settings and forward all required email addresses to a command structured in the following format:

php PATH_TO_LIVEAGENT/scripts/mail_pipe.php ACCOUNT_ID TOKEN
  • php should be the path to the PHP executable
  • PATH_TO_LIVEAGENT should be the full server path to the LiveAgent folder
  • ACCOUNT_ID must be extracted from the account-id query string parameter of the remote piping URL
  • TOKEN must be extracted from the token query string parameter of the remote piping URL


C:/wamp64/bin/php/php8.0.13/php.EXE /liveagent/scripts/mail_pipe.php abc123x 123456789abcdefg
/usr/bin/php /la/scripts/mail_pipe.php abc123x 123456789abcdefg

You can close the Piping integration window, the piping email account will be already created in your LiveAgent incoming email accounts list and will start fetching emails once you configure the email piping on your mail server.