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

# Ticketing Connectors

> Integrate AGO with customer support ticketing systems

Ticketing connectors link AGO to your customer support ticketing systems. When users
need human assistance, AGO creates support tickets in your preferred platform automatically.

## Connector Comparison

| Feature                 | AGO Internal                      | HelpScout          | Zendesk                          | HubSpot                |
| ----------------------- | --------------------------------- | ------------------ | -------------------------------- | ---------------------- |
| **Authentication**      | None required                     | OAuth2             | API Token                        | Bearer Token           |
| **Ticket Model**        | Native tickets                    | Conversations      | Tickets                          | Tickets                |
| **User Creation**       | Automatic                         | Auto from email    | Requires existing user\*         | Auto from email        |
| **File Attachments**    | Yes                               | Yes                | Yes                              | Yes (via Notes)        |
| **Custom Fields**       | Full support                      | Tags only          | Full custom fields               | Full properties        |
| **Multi-brand**         | No                                | No                 | Yes                              | No                     |
| **Group/Assignment**    | Manual                            | Mailbox only       | Groups + Assignee                | Owner assignment       |
| **Priority Mapping**    | Native field                      | Via tags           | Native field                     | Native field           |
| **Typology/Category**   | Native field                      | Via tags           | Custom fields                    | Custom properties      |
| **Admin Dashboard**     | Built-in                          | HelpScout UI       | Zendesk UI                       | HubSpot UI             |
| **Email Notifications** | Configurable                      | HelpScout          | Zendesk                          | HubSpot                |
| **Ticket Sync**         | N/A                               | No                 | Yes (status, comments, assignee) | No                     |
| **Best For**            | Simple support, no external tools | Small-medium teams | Enterprise support               | CRM-integrated support |

\*Zendesk can auto-create users when "Allow All Users" is enabled

## Available Ticketing Connectors

AGO supports the following ticketing systems for automated ticket creation:

<CardGroup cols={2}>
  <Card title="HelpScout Integration" icon="life-ring" href="/data-connector/helpscout-integration">
    Create support tickets in HelpScout conversations with OAuth2 authentication, file attachments, custom tagging, and automatic customer creation from email.
  </Card>

  <Card title="Zendesk Ticketing Integration" icon="headset" href="/data-connector/zendesk-ticketing-integration">
    Create tickets in Zendesk Support with custom field mapping, group assignment, tag management, and multi-brand account support.
  </Card>

  <Card title="HubSpot Ticketing Integration" icon="hubspot" href="/data-connector/hubspot-integration">
    Create tickets in HubSpot Service Hub with contact auto-creation, custom property mapping, owner assignment, and priority routing.
  </Card>
</CardGroup>

## How Ticketing Connectors Work

1. **User Request**: User asks to speak with a human or report an issue
2. **Ticket Creation**: AGO creates a ticket in your ticketing system
3. **Context Transfer**: Conversation history and relevant information are included
4. **Notification**: Your support team is notified
5. **Follow-up**: Support team handles the ticket in their system

## Integration Flow

1. AGO receives the user's request and identifies the need for a ticket
2. The agent collects conversation history, user information, and any file attachments
3. AGO creates a ticket in your connected ticketing system
4. Your support team receives the ticket with full context

## Choosing a Ticketing Connector

Select the connector that matches your support platform:

| Connector        | Best For                                                                              |
| ---------------- | ------------------------------------------------------------------------------------- |
| **AGO Internal** | Small teams without existing ticketing systems, simple support needs                  |
| **HelpScout**    | Email-based customer support with conversation threads, small-medium teams            |
| **Zendesk**      | Enterprise support with advanced routing, custom fields, and multi-brand capabilities |
| **HubSpot**      | Teams already using HubSpot CRM who want unified customer data and support            |

### Decision Guide

* **No existing ticketing system?** → Use AGO Internal for built-in ticket management
* **Email-centric workflow?** → HelpScout excels at conversation-based support
* **Enterprise requirements?** → Zendesk offers the most advanced features and integrations
* **Already using HubSpot CRM?** → HubSpot connects CRM and support data

## Getting Started

1. Choose your ticketing platform from the list above
2. Generate API credentials in your ticketing system
3. Configure the connector in AGO administration
4. Set up custom field mappings (priority, typology, tags)
5. Test ticket creation with a sample conversation
6. Enable for production use

For best practices on form design, field mapping, and workflow optimization, see [Ticketing Best Practices](../guides/ticketing-best-practices).