A caller gives your team an email address. Is there already a contact for that person, or should you save a new one? HeyRik's Freshdesk integration gives your assistant two direct tools for that moment: exact-email contact lookup and optional creation of a new contact after the caller confirms the details and agrees to saving them.
This is not a call-end webhook. The assistant asks Freshdesk during the conversation and receives the result through HeyRik's existing tool system. For example, an Indian customer-support team already using Freshdesk could check whether a caller's confirmed email has a contact before collecting details again. Each assistant has its own connection and permissions. The first version deliberately stays focused on contacts; it does not read tickets or modify existing records.
Find a contact without importing your customer list
The freshdesk_find_contact tool uses an exact email confirmed by the caller. It returns only a contact ID, name and email when a match is found. Tickets, notes, addresses, stored phone numbers and custom fields are not returned to the assistant.
An email match is not identity verification. Configure your assistant not to disclose stored information to an unverified caller. Freshdesk text is treated as external data, not instructions for the agent.
Capture confirmed details with a separate permission
Enable new-contact creation only for assistants that need it. The freshdesk_create_contact tool requires a name, email and a confirmation flag representing the caller's agreement to save those details. A phone number is optional and must include its country code. Your assistant instructions must require that agreement before calling the tool.
The connector creates new contacts only. It does not overwrite an existing contact or automatically retry an uncertain write. If the request times out, the assistant must not say the contact was saved; it should check by email or hand the issue to your team. Duplicate-contact errors are not reported as successful creation.
Connect a test assistant first
- 1Open Connected apps, choose your assistant and select Freshdesk.
- 2Enter your Freshdesk subdomain, such as your-team, and an agent API key with the contact permissions you need. Only accounts addressed as <subdomain>.freshdesk.com are supported. Custom domains are not supported.
- 3Save the connection. HeyRik checks read access without creating a contact and encrypts the credentials. Changing the subdomain requires entering the key again.
- 4Enable lookup and, if needed, separately allow new contact creation. New calls receive the enabled tools.
- 5Tell your assistant when to use each tool, how to obtain confirmation and how to handle unavailable results. Test a known email, an unknown email and a consented new contact before relying on it.
Know the limits before enabling it
API requests have bounded waits, but a provider outage or rate limit can still prevent an action. Disabling the connection blocks subsequent tool requests; an in-flight request may finish. Contact data passes through HeyRik's tool system and AI provider, so review your privacy obligations and tool-log access.
Start with one test assistant and a dedicated test contact. Check the resulting record in Freshdesk, verify that the assistant handles failures honestly, and confirm that it does not disclose information based solely on an email match. Then enable the connection for the assistants that need it. This release does not provide ticket operations, bulk imports, automatic post-call sync or an India data-residency guarantee. Open Connected apps to configure your contact workflow.
A little more before you begin.
Can this update an existing contact?
No. This version supports exact-email lookup and new-contact creation only.
Does saving the API key create a contact?
No. Saving new credentials checks read access. Creation happens only through the enabled creation tool.
Are contact writes guaranteed to succeed?
No. Permissions, rate limits and network failures can prevent or obscure the result. The assistant must wait for the tool result and avoid claiming success on an uncertain outcome.
Start here
Connect your assistant to Freshdesk
Build a voice agent, upload your list or connect your leads, and run your first campaign on HeyRik — free to start, no credit card required.