Zvoove Integrations

Connect your KI Agency platform with Zvoove to bring candidate data into your campaigns.

What is Zvoove?

Zvoove digitizes the daily work of staffing teams. In KI Agency you can now use two Zvoove integrations:

• Zvoove Recruit for new applications
• Zvoove Temp Agency for talent pool candidate research

Which integration should you choose?

• Choose Zvoove Recruit if you want to sync new applications into a campaign.
• Choose Zvoove Temp Agency if you want to search existing talent pool candidates.
• Both integrations help you import contacts from Zvoove into KI Agency campaigns.

---

Setting Up Zvoove Integrations

Prerequisites

Before setting up the integration, you'll need:

• Access to your Zvoove account
• API credentials from Zvoove
• Your Zvoove tenant name (the part before .europersonal.com in your Zvoove URL)

Step 1: Connect the correct Zvoove integration

1. Navigate to Integrations in the main menu
2. Find Zvoove Recruit or Zvoove Temp Agency in the list
3. Click Connect
4. Enter the requested credentials
5. If your setup asks for a tenant name, enter the part before .europersonal.com in your Zvoove URL
6. Click Connect to establish the connection

Step 2: Verify Connection

After connecting, you should see:

• A green "Connected" status on the selected Zvoove integration card
• The integration appears as available in your campaign settings

---

Using Zvoove with Campaigns

Once connected, you can configure your campaigns to work with Zvoove data:

Campaign Integration Setup

1. Open any campaign from your campaigns list
2. Go to the tab for Zvoove Recruit or Zvoove Temp Agency
3. Enable the integration by turning on the switch
4. Configure the following settings:

Search Type

Choose which kind of Zvoove search should run:

• Zvoove Recruit → Default - New Applications: Syncs newly added applications since the last successful sync.
• Zvoove Recruit → Talent Pool Research: Searches candidates that already exist in your Zvoove Recruit talent pool.
• Zvoove Temp Agency → Talent Pool Research: Searches candidates that already exist in your Zvoove talent pool.
• Zvoove Temp Agency → Available Employees: Finds employees without assignments or absences during the selected availability period. You can also limit the search to their home department.

When you select Talent Pool Research in Zvoove Recruit or Zvoove Temp Agency, fill in the required field:

• Days since last change: Enter a number of days. The system searches for candidates whose latest profile change is older than this number.

For Available Employees, set the two required number fields:

• Available from (days from today) (default: 0): Choose how many days from the day of the run the availability period starts. 0 means today.
• Availability window (days) (default: 7): Choose how many days employees must be free of assignments and absences. The first day is included.

For Talent Pool Research in Zvoove Recruit, you can also use these optional source filters:

• Search (searchTerm): Search by company name, candidate name, or another useful term.
• Candidate Status (candidateStatus): Filter by one or more candidate statuses. Separate multiple statuses with commas.

AI Filter

Add a short description of what the AI should treat as relevant. This is not the same as source search fields such as Search (searchTerm) that filter Zvoove results. For example:

• "Focus on leads from automotive industry with budget > $50k"
• "Target candidates for senior management positions"

If the selected Zvoove integration is enabled, you must add an AI Filter or attach at least one reference before saving.

Search (optional, searchTerm, Zvoove Recruit)

For Default - New Applications, this field narrows the source search in Zvoove itself (for example by company name, candidate name, or another useful keyword). This search field is optional and does not replace the required AI Filter or attached reference for an enabled integration.

Attach References

Select specific campaign references from your Zvoove system:

• Browse available references from your connected Zvoove account
• Select multiple references that match your campaign goals
• The system will automatically sync data from these references

If you leave the AI Filter empty, select at least one reference here before saving.

Push Results Back

Push Results Back is not supported for Zvoove Recruit or Zvoove Temp Agency. Call outcomes are recorded in your KI Agency campaigns but are not automatically sent back to Zvoove. All call data remains available in your dashboard for analysis.

Campaign Automation

When properly configured, the integration will:

• Automatically pull relevant contacts from Zvoove based on your settings
• Trigger campaigns when new applications or matching talent pool candidates are found in Zvoove
• Keep campaign data synchronized between both systems
• Re-check contacts after a settings change: When you update filters, references, or additional fields for Zvoove Recruit or Zvoove Temp Agency, the next trigger run checks all available contacts again with the updated configuration.

Using with Campaign Preselection

Both Zvoove integrations work with the Campaign Preselection feature. When you have both enabled:

• Automatic Filtering: Contacts imported from Zvoove can be automatically evaluated by AI based on your preselection criteria
• Quality Control: The AI reviews each candidate against your specific requirements before they enter the calling queue
• Efficiency: Only the most relevant candidates are called, saving time and improving campaign results
• Smart Overwrites: The AI can suggest personalized field values for approved contacts based on their Zvoove data

To use this feature:

1. Enable preselection in your campaign's Preselection tab
2. Define your filtering criteria (e.g., "Focus on candidates with 5+ years of experience in IT management")
3. The AI will automatically evaluate contacts as they are imported from Zvoove
4. Review and approve/reject contacts in the Preselection Contacts tab

---

Contact Synchronization

The selected Zvoove integration also handles contact management:

Automatic Phone Number Formatting

• Phone numbers from Zvoove are automatically formatted to international standards
• Duplicate contacts are prevented by matching phone numbers
• Invalid phone numbers are filtered out during import

Contact Import Process

• Contacts are imported in batches for better performance
• The system handles large imports (1000+ contacts) efficiently
• Import status and errors are tracked and reported

---

Troubleshooting

Common Issues

Integration Not Connecting

• Verify your API key is correct
• Check that your tenant name matches your Zvoove URL
• Ensure you have proper permissions in your Zvoove account

No Campaign References Available

• Verify your Zvoove account has active campaigns
• Check that your integration permissions allow access to campaign data
• Contact your Zvoove administrator if references or talent pool data are missing

Cannot Save the Enabled Integration

• Add an AI Filter or select at least one reference
• Remember that the optional Search field alone is not enough

Phone Number Issues

• The system automatically formats phone numbers to international standards
• Invalid phone numbers will be skipped during import
• Check the import report for any formatting errors

Getting Help

If you encounter issues with a Zvoove integration:

1. Check the integration status in the Integrations section
2. Review any error messages in the campaign logs
3. Contact your system administrator
4. Reach out to support if problems persist

---

Security Notes

• Your API keys are stored securely and encrypted
• Only authorized personnel should have access to integration settings
• Regularly review connected integrations and remove unused ones
• Follow your organization's security policies for external system access

---

For additional support with Zvoove integrations, please contact your system administrator or our support team.