The Ringover integration with Firefish connects your recruitment CRM directly with cloud telephony, enabling one-click calls, multi-channel activity logging, and contact synchronisation. In this guide, you’ll learn how to generate your API credentials in Firefish, activate the integration in Ringover, configure custom settings, and place calls using the dialler.
Prerequisites
- An active Ringover Business account or higher.
- Administrative or technical permissions on your Ringover Dashboard.
- An administrator account in Firefish.
Connect and configure Firefish integration
1. Generate API credentials in Firefish
Create a custom API profile within your Firefish settings to obtain your authorisation keys.
- Log in to your Firefish account.
- Open the Settings menu at the top of the page.
- Click on Integrations from the dropdown menu.
- Navigate to the Custom API tab.
- Create a new API Profile with the required permission scopes.
- Keep the page open to copy your Profile Name, Client ID, and Client Secret.
2. Activate Firefish in Ringover
Enter your Firefish credentials into your Ringover Dashboard to authorise the integration.
- Log in to your Ringover Dashboard.
- Go to Store > Integrations.
- Search for Firefish and click on it.
- Enter your Firefish URL, Profile Name, Client ID, and Client Secret.
- Click Activate.
.jobs (e.g., https://yourcompany.jobs). Do not include trailing slashes or subpaths.3. Configure your integration settings
Customise how contacts, calls, and messages synchronise between Ringover and Firefish.
- Call types: Manage and filter categories for inbound, outbound, or missed calls.
- Include recordings in call logs: Select which call audio recordings (e.g., "All files") are attached to call logs.
- Restrict access to recordings: Toggle switch to limit user access permissions for audio recordings.
- Phone numbers: View and manage connected phone lines or select specific numbers.
- SMS messaging numbers: Select and manage phone numbers designated for SMS messaging.
- Group SMS conversations by: Select the time interval used to group SMS messages into threads (e.g., "Do not group").
- Link users with an account: Map Firefish software users or agents to their corresponding system account via "Manage users".
- Assign missed IVR calls to: Choose a default user or team member (e.g., "Add user") to assign unhandled IVR calls.
- Log internal calls: Toggle switch to automatically log internal team calls within Firefish software.
- Include Ringover summaries in call logs: Toggle switch to attach Ringover call summaries to call logs.
- Include scenario name in call logs (for incoming IVR calls): Toggle switch to append the specific IVR scenario name to incoming call logs.
- Logs display language: Select the language used to display call log details (e.g., "en").
- Type of object created: Choose the default CRM record type created for new contacts (e.g., "contacts").
- Log WhatsApp messages: Toggle switch to automatically save WhatsApp chat messages to CRM logs.
- Create contact for calls: Choose when new contacts are automatically created during calls (e.g., "No contact page created").
- Create contact for SMS messages: Choose whether incoming/outgoing SMS messages trigger automatic contact creation (e.g., "None").
- Create contact for WhatsApp messages: Toggle switch to automatically generate new contacts from WhatsApp conversations.
- Sync contacts (v4): Toggle switch to enable general contact synchronisation with Firefish software.
- Sync contacts on a call-by-call basis: Toggle switch to trigger contact synchronisation individually as each call occurs.
- Display contact's info during call and only store their info if call-by-call basis is activated: Toggle switch to show contact details on the dialler during calls while conditionally restricting data storage unless call-by-call sync is enabled.
- Mapped fields: Select Firefish software fields to display in the dialler's Info section via "Add or edit fields".
4. Place calls and log activities in Firefish
Use the browser dialler extension to call contacts directly from candidate records.
- Install the Ringover Dialer extension in your browser ( 🔗 How to use Ringover Dialer extension on Google Chrome).
- Open any contact or candidate file inside Firefish.
- Click on the Call & Message button or any highlighted phone number to dial.
- Review the candidate activity history after the call to see logged notes, AI summaries, and transcript links.
🎉 You now know how to connect and configure the Firefish integration and can manage all your recruitment calling and candidate outreach directly inside Firefish!