📑 Table of Contents
- What is the Integration Logic Between MyOperator and FreshDesk?
- What Are the Initial Setup Steps for Integration?
- How Does Agent Synchronization Work?
- What Happens When Ticket Assignment Occurs?
- What Are the Webhook Configuration Steps?
- Webhook Payload Template
- What Are the Common Troubleshooting Tips?
- Frequently Asked Questions (FAQs)
- Ticket Assignment Logic
- Related articles
1. What is the Integration Logic Between MyOperator and FreshDesk?
The MyOperator + FreshDesk Integration allows seamless syncing of data, including call records and ticket assignments, between the two platforms. Here’s a brief overview of the integration logic:
- API Key and Domain Validation:
- The FreshDesk API key and domain are validated during the setup process. If the credentials are valid, the sync proceeds. If they are incorrect, an error warning is shown.
- Agent Synchronization:
- All agents in FreshDesk are fetched and synced to MyOperator for ticket assignment. Agents can also be manually synced using the Sync Users button.
- Ticket Creation:
- A new ticket is created in FreshDesk for every incoming or outgoing call.
⬆️ Back to Top
2. What Are the Initial Setup Steps for Integration?
To set up the FreshDesk Integration with MyOperator, follow these steps:
- Login to MyOperator:
- Go to APIs and Webhooks in the MyOperator panel.
- Connect FreshDesk:
- Click on the FreshDesk Connect button to begin integration setup.
- Enter Your Details:
- Provide the required information, including:
- Company ID
- FreshDesk Domain
- API Key
- Filter Criteria (for ticket creation and assignment).
- Validate Credentials:
- Click Submit to verify your FreshDesk API Key and domain. If the credentials are valid, the integration will proceed.
⬆️ Back to Top
3. How Does Agent Synchronization Work?
Agent synchronization ensures that your FreshDesk agents are properly mapped in MyOperator. Here’s how it works:
- Automatic Sync:
- All agents from FreshDesk are fetched automatically into MyOperator during integration.
- Manual Sync:
- If necessary, you can click the Sync Users button to manually sync agents between MyOperator and FreshDesk.
⬆️ Back to Top
4. What Happens When Ticket Assignment Occurs?
Ticket assignment happens based on the agent availability and email matching:
- Agent Exists in FreshDesk:
- If the agent exists in FreshDesk, the ticket is automatically assigned to them.
- Agent Does Not Exist:
- If the agent does not exist, the ticket remains unassigned.
Each incoming or outgoing call will trigger the creation of a new ticket in FreshDesk.
⬆️ Back to Top
5. What Are the Webhook Configuration Steps?
To configure the AfterCall Webhook in MyOperator:
- Go to API Settings:
- In MyOperator, navigate to APIs and Webhooks > Add New Webhook.
- Select Webhook Type:
- Choose AfterCall Webhook and set the Method to POST and Content-Type to JSON.
- Enter Webhook URL:
- Use the provided webhook URL to send ticket data from MyOperator to FreshDesk.
⬆️ Back to Top
🧾 Webhook Payload Template
{ "subject": "{Event} {Status} call from {caller}", "status": "Open", "priority": "Medium", "description": "Caller: {Caller Number}\nAgent: {Agent Name}\nDepartment: {Department Name}\nStatus: {Call Status}\nEvent: {Call Event}\nDuration: {Duration}\nUID: {Call UID}\nRecording: {Recording Link}\nStart Time: {Start Time}"}
6. What Are the Common Troubleshooting Tips?
Here are some common troubleshooting tips for integration issues:
- Invalid API Key or Domain:
- Double-check the FreshDesk API Key and domain to ensure they are correct and up to date.
- Webhook Not Triggering:
- Ensure the AfterCall Webhook is active in MyOperator and that the payload format matches the required JSON.
- Agent Not Assigned:
- Ensure that the agent’s email in MyOperator exactly matches the one in FreshDesk for proper ticket assignment.
⬆️ Back to Top
7. Frequently Asked Questions (FAQs)
Q1. Can I customize the ticket fields created in FreshDesk?
- Yes, you can customize ticket fields in FreshDesk. Use FreshDesk's customization features to add custom fields as needed.
Q2. What happens if an agent’s email doesn’t match between MyOperator and FreshDesk?
- If there’s an email mismatch, the ticket will not be assigned to the agent, and the ticket will remain unassigned.
Q3. How do I check if the webhook is properly set up?
- Ensure the AfterCall Webhook is correctly set up in MyOperator. You can verify this by checking the Webhook Settings and making sure the POST method and JSON content type are configured correctly.
⬆️ Back to Top
👥 Ticket Assignment Logic
- If Agent exists in Freshdesk: Ticket is assigned to that agent.
- If Agent does not exist: Ticket remains unassigned.
- A ticket is created for each Incoming or Outgoing call.
⬆️ Back to Top
🔗 Related articles
⬆️ Back to Top
📌 Keywords:
FreshDesk, MyOperator, ticket assignment, integration, webhook, API key, agent sync, email matching, troubleshooting.