# Blesta

Integration created in house by Timothy.

# Plugin Installation

To install the plugin simply download the plugin from: [https://github.com/ticaga/ticaga\_blesta](https://github.com/ticaga/ticaga_blesta)

Upload the **ticaga\_support** folder to the **plugins** folder inside your Blesta installation.

Afterwards head over to the Blesta admin and go to the Settings, click on Plugins, and Available. Hit on Install and you'll be greeted with the following:

[![ticaga_plugin.png](https://docs.ticaga.com/uploads/images/gallery/2024-12/scaled-1680-/cS1Fvr42ngy9M0W4-ticaga-plugin.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/cS1Fvr42ngy9M0W4-ticaga-plugin.png)

Click on **Manage** to set-up the API:

[![Screenshot 2025-09-15 at 16.34.34.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/gdqKurhA0cLJqTgd-screenshot-2025-09-15-at-16-34-34.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/XfldqT03Bwypn8KB-api-setup-page.png)

The **API URL** is your Ticaga installation link, for example **[https://support.ticaga.com](https://support.ticaga.com)**.

The **Admin Email Address** is your admin email address for Ticaga.

The **API Key** is the api key you can grab from Ticaga, simply log into your Ticaga installation, click on your name in the bottom left, select on **Settings** then select **API Details**.

[![Screenshot 2025-09-15 at 16.39.47.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/ZzGiSQ5soE3xEsXO-screenshot-2025-09-15-at-16-39-47.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/WK4zMnr5EHUuzQux-api-tokens.png)

The Email is your **Admin Email Address**.  
The Token is your **API Key**.  
<span style="text-decoration: underline;">**If you don't have one, click on Create a Token to generate a new one.**</span>

---

#### <span style="text-decoration: underline;"></span>Portal Link

Want something like ours:

[![Screenshot 2025-09-15 at 17.02.50.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/scaled-1680-/EgAUzptOja69jnIS-screenshot-2025-09-15-at-17-02-50.png)](https://docs.ticaga.com/uploads/images/gallery/2025-09/EgAUzptOja69jnIS-screenshot-2025-09-15-at-17-02-50.png)

Simply add this to your Portal plugin on Blesta: Settings &gt; Company &gt; Plugins &gt; Portal: manage and add this:

```html
{% if plugins.ticaga_support.enabled %}
    <div class="col-md-4 col-sm-6 portal-box">
        <a href="{blesta_url}plugin/ticaga_support/client_main/departments/">
            <div class="card">
                <div class="card-body">
                    <i class="fas fa-ticket-alt fa-4x"></i>
                    <h4>Support</h4>
                    <p>You can open a trouble ticket here.</p>
                </div>
            </div>
        </a>
    </div>
{% endif %}
```

# How Clients can open a ticket.

To open tickets on Blesta, your customers **need to sync** their Ticaga account to Blesta.

Simply clicking on **Support** shows this page:

[![clients-please-sync.png](https://docs.ticaga.com/uploads/images/gallery/2024-12/scaled-1680-/kUehJbKU57hJnWM4-clients-please-sync.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/kUehJbKU57hJnWM4-clients-please-sync.png)

Your customers can find their **customer ID** on Ticaga by clicking their name on the bottom left:

[![Screenshot 2025-09-15 at 16.47.27.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/scaled-1680-/bVVfR89IQ1MwvT4k-screenshot-2025-09-15-at-16-47-27.png)](https://docs.ticaga.com/uploads/images/gallery/2025-09/bVVfR89IQ1MwvT4k-screenshot-2025-09-15-at-16-47-27.png)

Their Ticaga email address **must** **match** their Blesta email address else the syncing will not work.

We've got two tasks to help make this more streamlined: [Blesta Plugin - Automatically Sync](https://feedback.ticaga.com/boards/feature-requests/posts/blesta-plugin-automatically-sync) &amp; [Blesta Plugin - Sync Manually](https://feedback.ticaga.com/boards/feature-requests/posts/blesta-plugin-sync-manually).   
No ETA yet, on these but we do have these planned, if it will benefit you, please +1 them so we know we may need to do them sooner rather than later.

After your customer has provided the following details they'll be shown this page:

[![clients-sync-completed.png](https://docs.ticaga.com/uploads/images/gallery/2024-12/scaled-1680-/BMaJ2hAEXMd7JrmD-clients-sync-completed.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/BMaJ2hAEXMd7JrmD-clients-sync-completed.png)

Now when your customer clicks on **Create a ticket**, they'll be shown the support departments they can open tickets in:

[![ticaga_departments.png](https://docs.ticaga.com/uploads/images/gallery/2024-12/scaled-1680-/JONacatYc3FbhVZO-ticaga-departments.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/JONacatYc3FbhVZO-ticaga-departments.png)

Your client can click on a department and be shown the create a ticket form, if they can use high priorities they'll be displayed here too:

[![Screenshot 2025-09-15 at 14.23.20.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/8UkFZ6viRXhoG1YN-screenshot-2025-09-15-at-14-23-20.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/WKoVq5iZA4azMWr6-create-ticket.png)

Or if the department allows Priorities they'll see this:

[![Screenshot 2025-09-15 at 16.58.26.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/scaled-1680-/8l98uSEa2tezJ9dJ-screenshot-2025-09-15-at-16-58-26.png)](https://docs.ticaga.com/uploads/images/gallery/2025-09/8l98uSEa2tezJ9dJ-screenshot-2025-09-15-at-16-58-26.png)

After they've submitted a ticket, they'll be shown all the tickets:

[![clients-all-tickets.png](https://docs.ticaga.com/uploads/images/gallery/2024-12/scaled-1680-/7W46dPtA12FEhiUo-clients-all-tickets.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/7W46dPtA12FEhiUo-clients-all-tickets.png)

Clicking View ticket shows the replies from employees and the customer:

[![Screenshot 2025-09-15 at 14.28.09.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/cQXIiMqoSwqhLu7t-screenshot-2025-09-15-at-14-28-09.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/4DYspZZTQbxtVOda-clients-1.png)

I want to re-add the Ticket information on the next update to the Blesta plugin like the old one:

[![clients-2.png](https://docs.ticaga.com/uploads/images/gallery/2024-12/scaled-1680-/SCVqHEbHi1UCGAxm-clients-2.png)](https://docs.ticaga.com/uploads/images/gallery/2024-12/SCVqHEbHi1UCGAxm-clients-2.png)

# How Guests can open a ticket.

Since version 2.0.0 of the Blesta plugin, your visitors (guests) can finally submit a ticket to your team.

They can click on **Support &gt;&gt; Departments** or if you've added a link to your portal they can simply click a link, they'll see the list of departments which are "public":

[![Screenshot 2025-09-15 at 17.03.07.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/scaled-1680-/VaVjmsVIADpeBSKO-screenshot-2025-09-15-at-17-03-07.png)](https://docs.ticaga.com/uploads/images/gallery/2025-09/VaVjmsVIADpeBSKO-screenshot-2025-09-15-at-17-03-07.png)

They simply click on the department to see the form:

[![Screenshot 2025-09-15 at 17.05.09.png](https://docs.ticaga.com/uploads/images/gallery/2025-09/scaled-1680-/4C0CMAYunDOWKjwZ-screenshot-2025-09-15-at-17-05-09.png)](https://docs.ticaga.com/uploads/images/gallery/2025-09/4C0CMAYunDOWKjwZ-screenshot-2025-09-15-at-17-05-09.png)

They need to supply their Full Name and Email Address, unlike your customers who are logged in.