Integration Reference Technical and functional reference for Avionté certification review

Avionté
Integration Guide

Technical and functional reference for Introvy's certified integration with Avionté BOLD Front Office — covering architecture, workflows, stage mapping, write-back, and certification notes.

Prepared for Avionté Certified Integration review
01 / overview

Overview

Introvy is a post-screening candidate workflow platform for staffing firms.

It integrates directly with Avionté BOLD Front Office to automate what happens after a recruiter has already screened a candidate — including Video Submission, interview preparation, and post-interview follow-up.

When a recruiter moves a candidate through the Avionté pipeline, Introvy receives the webhook event, enriches it through the Avionté API, maps the pipeline stage to the appropriate workflow, prepares the candidate, and writes structured results back to the Avionté Talent record.


02 / core value

Core Value

Introvy helps Avionté staffing firms:

Improve candidate quality before submission to the client
Improve interview readiness and show rates
Reduce recruiter follow-up effort after screening
Strengthen client-facing candidate submissions
Write structured workflow activity back to Avionté Talent records
Turn post-screening activity into searchable, structured ATS data inside Avionté

03 / process

How It Works

Recruiter moves a candidate to a stage in Avionté BOLD Front Office.

Avionté sends a webhook event to Introvy with the pipeline and tenant context.

Introvy validates the request and enriches the event.

Introvy calls the Avionté API to fetch candidate name and email, job title, company, and recruiter context.

Recruiter reviews and approves when required.

Candidate receives and completes their workflow.

Results are written back to the Avionté Talent record as a structured activity note.

Recruiter receives a review notification. Activity note appears in the candidate's Avionté record with summary, link, and completion status.


04 / event mapping

Event Mapping

Avionté stage names are free-form text configured per tenant. Introvy ships with a conservative default map based on stages validated in the Avionté sandbox (apitest tenant). Additional customer-specific stages can be confirmed and mapped during onboarding.

Avionté Pipeline Stage Workflow Triggered
Pipelined Video Submission
Online Interview Scheduled Research Brief Practice Audio Practice Video
Onsite Interview Scheduled Research Brief Practice Audio Practice Video
Pre-screen Interview Scheduled Research Brief Practice Audio Practice Video
Selected Thank You
Pre-screen Interview Completed Thank You
AI Interview Completed Thank You
Rejected, Declined, Not Selected, DisqualifiedNo action
Withdrawn, Candidate WithdrewNo action
On Hold, No Show, RescheduledNo action
Hired, Placed, Started, Closed, FilledNo action
Background Check, Drug Screen, Safety Test, Possible Hire TestNo action
Applicant, Candidate, Sourced, Screening, Phone ScreenNo action
All other unrecognized stagesUnknown — logged and dropped, never queued
Only stages validated in the Avionté sandbox are listed as actionable. Any unrecognized stage is logged and dropped — never queued or retried. Additional customer stages are mapped during onboarding after confirmation.

05 / workflows

Workflow Breakdown

🎬

Video Submission

trigger: Pipelined / Submitted

Description

Video Submission is used after the recruiter has already screened a candidate. It helps recruiters create stronger, more differentiated submissions with structured video responses and AI-generated summaries.

Why this matters: Video Submission gives hiring managers more context than a resume alone. The submission link, AI summary, and key concepts are written back to the Avionté Talent record automatically — creating a reusable asset the recruiter can reference on future calls.
✓ client-shareable

Flow

AI generates role-specific questions from job description
Recruiter reviews and approves or edits questions
Candidate records video responses
AI processes transcript and generates summary
Results written back to Avionté Talent record

Write-back includes

Shareable submission link
AI-generated summary of candidate responses
Key concepts extracted from transcript
Activity note on candidate Talent record
📋

Research Brief

trigger: Online / Onsite / Pre-screen Interview Scheduled

Description

Research Brief provides candidates with structured preparation material before their interview. For internal and candidate use only.

Why this matters: Research Brief helps candidates walk into interviews better informed, more confident, and more aligned with what the interviewer is likely to care about.
⚠ internal + candidate only

Includes

Company overview and recent news
Role expectations and key priorities
Likely interview questions
Suggested talking points
Smart questions to ask the interviewer
🎙️

Practice Audio

trigger: Online / Onsite / Pre-screen Interview Scheduled

Description

Practice Audio is a low-friction interview rehearsal workflow. For internal and candidate use only.

Why this matters: Practice workflows improve interview readiness, confidence, and communication quality. Candidates show up more prepared and create a stronger impression with the client.
⚠ internal + candidate only

Includes

5 role-specific practice questions
Audio response recording
AI feedback on each response
Coaching notes and improvement suggestions
📹

Practice Video

trigger: Online / Onsite / Pre-screen Interview Scheduled

Description

Practice Video is a higher-intensity interview preparation workflow. For internal and candidate use only.

Why this matters: Practice workflows improve interview readiness, confidence, and communication quality. Candidates perform better in interviews and create a stronger impression with the client.
⚠ internal + candidate only

Includes

2 role-specific video practice questions
Video response recording
AI coaching feedback
Structured improvement guidance
💌

Thank You

trigger: Selected / Pre-screen Interview Completed / AI Interview Completed

Description

Thank You is used after interviews. It gives candidates a professional, personal follow-up they can send to thank the interviewer and reinforce their interest in the role.

Why this matters: A strong follow-up can differentiate a candidate and keep momentum after the interview. The shareable link can be forwarded directly to the hiring manager.
✓ designed to share with hiring manager

Includes

Candidate video or written message
Role and company context
Shareable follow-up link
Activity note written back to Avionté

06 / write-back

Avionté Write-back

Each completed workflow creates a structured activity note on the candidate's Avionté Talent record. Write-backs convert candidate activity into searchable recruiter signal inside Avionté.

Video Submission — completion note enhanced
[Introvy] Video Submission completed Review at: https://www.introvy.ai/submission/{token} Summary: [AI-generated summary of candidate responses] Application: avionte:apply:{talentId}:{jobId} Job: [jobId] Completed: [ISO 8601 UTC timestamp]
Includes AI summary derived from candidate video transcript. Written to the candidate Talent record in Avionté after processing completes. Deferred and retried if AI processing is not yet ready.
Interview Prep / Thank You — completion note standard
[Introvy] Interview Prep sent Candidate: [First Last] Role: [Job Title] at [Company] Workflows: Research Brief, Practice Audio, Practice Video Completed: [ISO 8601 UTC timestamp]
All write-back notes are redacted before transmission — SSNs, tokens, API keys, account numbers, and secrets are stripped automatically. Avionté remains the system of record.

07 / setup

Setup Process

Customer setup is straightforward. Introvy handles all integration configuration.

1

Customer submits data-sharing consent ticket at support.avionte.com.

References the Introvy integration. Avionté support triages and shares credentials via secure SharePoint.

2

Introvy creates the customer's ATS configuration.

FrontOfficeTenantId is mapped to the customer's Introvy organization. No per-customer webhook URL is required.

3

Avionté registers the Introvy webhook for the customer tenant.

Avionté subscribes job_pipeline_talent_added and job_pipeline_talent_updated to the shared Introvy callback URL.

Introvy handles:
Multi-tenant routing
Stage mapping
Workflow logic
Write-back formatting
Deduplication
API enrichment

No changes are required inside Avionté beyond webhook registration.

4

Introvy validates the integration with a test pipeline event.

Confirms stage routing, enrichment, workflow delivery, and write-back are all working correctly for the customer tenant.


08 / architecture

System Architecture

Introvy operates as an event-driven workflow layer between Avionté BOLD Front Office and candidates.

Event flow
Avionté BOLD webhook Introvy webhook receiver (Vercel) Validate X-Payload-Signature Resolve org by FrontOfficeTenantId agent_jobs queue (Supabase) MCP worker (Render) Avionté API enrichment (pipeline / talent / job / user) Stage router Workflow generated Recruiter approval Candidate completes Avionté Talent activity write-back

Webhook Endpoint

Production URLPOST https://api.introvy.ai/api/webhooks/avionte
Eventsjob_pipeline_talent_added   job_pipeline_talent_updated
AuthX-Payload-Signature header (shared secret)
ResponseHTTP 200 returned immediately — processing is async
Retry handlingAvionté retries up to 4 times — Introvy deduplicates by CorrelationId

Avionté API Calls (Outbound)

Auth tokenPOST /authorize/token — OAuth2 client credentials, 1h TTL
Pipeline dataPOST /front-office/v1/pipeline/multi-query
Talent dataGET /front-office/v1/talent/{id}
Job dataGET /front-office/v1/job/{id}
Recruiter dataGET /front-office/v1/user/{id}
Write-backPOST /front-office/v1/talent/{id}/activity

09 / behaviors

Key System Behaviors

Recruiter Approval (HITL)

Video Submission, Practice Audio, and Practice Video require recruiter approval before anything is sent to the candidate. Nothing goes to the candidate without confirmation.

Deduplication

Events are deduplicated by CorrelationId. Avionté retries are handled safely — no duplicate workflows are triggered.

Multi-tenant Routing

Shared webhook endpoint. Avionté sends FrontOfficeTenantId in every payload. Introvy routes to the correct customer org using field_mappings — no per-customer URLs.

Sensitive Field Scrubbing

SSNs, tax IDs, bank accounts, addresses, race, disability, and other sensitive fields are stripped from Avionté API responses before any data is used or stored.

Candidate Experience

Candidates access workflows via a unique link — no login, no app download. Works in any browser on any device. Explicit consent is captured before any recording begins.

Async Processing

Webhook returns HTTP 200 in under 100ms. All enrichment and workflow logic runs asynchronously. Avionté is never blocked waiting on Introvy.


10 / marketplace

Marketplace / Integration Notes

No UI changes required inside Avionté BOLD
Integration uses existing Avionté webhook + API model
Compatible with existing Avionté pipeline structures
Stage mapping configurable per tenant without code changes
Shared webhook URL — no per-customer endpoint configuration
Supports multiple active customer tenants simultaneously
Certified Integration Partner — Avionté+ Program. This integration requires an API subscription. Please reach out to your Avionté account manager to review. — effective June 2026. This integration requires an API subscription. Please reach out to your Avionté account manager to review.

Get in touch

For integration review, certification questions, or marketplace inquiries.