Which Placeholder can give me the right ID for a custom unsubscribe / Opt-out link

[Dekada]

Hello,
We don't want to expose our Espo installation to the outside (internet),
that is why I want to make a relay service for the unsubscribe links and tracking URLs...

My question is which placeholder gives me the right ID to build my own Opt-Out link (with different URL than the one we use internally)

Thanks

[victor]

All links (opt-out, unsubsrcibe, tracking url) that are generated automatically in EspoCRM contain a direct link to your instance.
At the moment, there is no such functionality in Espo.
You can try to create your own email placeholder (you need coding skills). Or you can contact the developers from the community of our forum in separate specialized sections:
- https://forum.espocrm.com/forum/developer-help
- https://forum.espocrm.com/forum/job-...find-developer

[yuri]

I added the placeholder: https://github.com/espocrm/espocrm/c...3241c09b3451fa. Will be available in 8.5. You can apply the change manually meanwhile.

[yuri]

Specially for cases like yours, you can set massEmailSiteUrl in the config. https://docs.espocrm.com/administrat...ms/#mass-email

massEmailSiteUrl – to override the default site url (can be helpful if there's no access to your CRM from the internet, but you need to handle opting out & tracking urls; you will need to configure your server to handle requests to the specified URL);

[yuri]

Impressed by what ChatGPT told:

You're absolutely right! The most efficient solution for handling unsubscribe requests in EspoCRM, when the instance is not exposed to the internet, is by configuring the `massEmailSiteUrl` parameter in the CRM’s config.

### How the `massEmailSiteUrl` Parameter Works:

1. **What It Does**:
The `massEmailSiteUrl` parameter is used to specify an external URL that will be embedded in your mass email campaigns as the unsubscribe link, even if your EspoCRM instance itself is not publicly accessible.

2. **How to Set It Up**:
- You configure an external server or service that can handle unsubscribe requests (this could be a simple script or a web service).
- Then, in your EspoCRM configuration, you set the `massEmailSiteUrl` to point to that external URL.

3. **Steps to Configure:**
- Open your EspoCRM configuration file (`data/config.php`).
- Add the following line:
```php
'massEmailSiteUrl' => 'https://your-external-site.com/unsubscribe-handler',
```
- In the URL, replace `https://your-external-site.com/unsubscribe-handler` with the URL of the server or service that will manage unsubscribe requests.

4. **Unsubscribe Mechanism**:
- When recipients click the unsubscribe link in an email, they are redirected to this external URL.
- You can configure the external service to update the EspoCRM records via API (if it has access) or maintain a list that you manually sync with EspoCRM to mark users as unsubscribed.

By using this approach, you ensure that unsubscribe requests are properly handled without exposing your CRM instance to the public internet.