Documentation | Syncora Systems

Onboarding Protocol

Welcome to Syncora. This guide walks you through the technical requirements for deploying your Voice AI infrastructure. Complete each step in order to ensure a smooth activation.

Estimated Setup Time

24-48 hours from kickoff to first live call. Enterprise deployments may require additional configuration.

Pre-Flight Checklist

Complete these requirements before your onboarding call:

Export Lead Data to CSV

Prepare a CSV file with columns: name, phone, email, company, interest_level

Verify Domain Ownership

Add a TXT record to your DNS: syncora-verify=your_org_id

Create Twilio Sub-Account

Set up a dedicated Twilio sub-account and share the Account SID and Auth Token via our secure portal.

Configure CRM OAuth

Grant Syncora read/write access to your CRM (HubSpot, Salesforce, or Pipedrive).

Provide Voice Sample (Optional)

For custom voice cloning, submit 3-5 minutes of clear audio with signed consent form.

Firewall Whitelisting

If your infrastructure uses IP-based access controls, whitelist the following Syncora egress IPs:

ip-whitelist.txtbash

# Syncora Production Infrastructure
# Region: US-East (Primary)
52.14.128.0/24
52.14.129.0/24
18.220.0.0/16

# Region: US-West (Failover)
54.67.0.0/16
13.52.0.0/16

# Region: EU-West (GDPR Compliant)
52.30.0.0/16
54.154.0.0/16

# Webhook Callback IPs
44.234.52.128/25
44.234.52.0/25

Important

IP ranges are subject to change. Subscribe to our status page for notifications:status.syncora.ai

API Reference

Authentication

All API requests require authentication via Bearer token. Include your API key in theAuthorization header:

headershttp

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Production Keys

Prefix: sk_live_
Use for live calls and production workflows.

Test Keys

Prefix: sk_test_
Use for development. Calls are simulated.

Trigger Call

Dispatch an AI voice agent to call a lead. The agent will follow your configured script and qualification criteria.

POST /v1/calls/dispatch

curl -X POST https://api.syncora.ai/v1/calls/dispatch \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+15550000000",
    "agent_id": "agent_sales_v4",
    "context": {
      "name": "John Doe",
      "company": "Acme Corp",
      "interest": "High",
      "product_focus": "Enterprise Plan"
    },
    "callback_url": "https://your-crm.com/webhooks/syncora",
    "priority": "high"
  }'

Response

response.jsonjson

{
  "call_id": "call_8f7d6c5b4a3e2f1g",
  "status": "queued",
  "estimated_start": "2026-01-25T14:30:00Z",
  "agent": {
    "id": "agent_sales_v4",
    "name": "Sales Concierge",
    "voice": "en-US-Neural-F"
  }
}

Call Status

Retrieve the status and outcome of a specific call.

GET /v1/calls/:call_id

call-status.jsonjson

{
  "call_id": "call_8f7d6c5b4a3e2f1g",
  "status": "completed",
  "duration_seconds": 187,
  "outcome": "qualified",
  "sentiment": "positive",
  "transcript_url": "https://api.syncora.ai/v1/transcripts/tr_xxxxx",
  "recording_url": "https://api.syncora.ai/v1/recordings/rec_xxxxx",
  "extracted_data": {
    "budget": "$50,000",
    "timeline": "Q2 2026",
    "decision_maker": true,
    "next_step": "demo_scheduled"
  }
}

Webhooks & Events

Webhook Setup

Syncora pushes real-time events to your configured webhook endpoints. Configure your callback URL in the dashboard or per-request.

webhook-payload.txthttp

POST https://your-crm.com/webhooks/syncora
Content-Type: application/json
X-Syncora-Signature: sha256=xxxxxxxxxxxxxxxx

{
  "event": "call.completed",
  "timestamp": "2026-01-25T14:35:00Z",
  "data": {
    "call_id": "call_8f7d6c5b4a3e2f1g",
    "outcome": "qualified",
    "lead": {
      "phone": "+15550000000",
      "name": "John Doe"
    }
  }
}

Signature Verification

Verify webhook authenticity by computing HMAC-SHA256 of the raw payload using your webhook secret and comparing to the X-Syncora-Signature header.

Event Types

Subscribe to specific events based on your integration needs:

Event	Description	Trigger
call.initiated	Call has been queued and is starting	Immediate
call.connected	Lead answered the phone	On pickup
call.completed	Call ended with transcript ready	On hangup
lead.qualified	Lead met qualification criteria	Post-analysis
sentiment.negative	Negative sentiment detected	Real-time
call.failed	Call could not be completed	On error
appointment.booked	Meeting scheduled in calendar	On confirmation

Integrations

HubSpot Integration

Connect Syncora to HubSpot for automatic lead syncing, activity logging, and deal creation.

Navigate to Integrations

Go to Dashboard → Settings → Integrations

Connect HubSpot

Click "Connect HubSpot" and authorize via OAuth 2.0. Grant access to Contacts, Deals, and Activities.

Configure Field Mapping

Map Syncora fields to HubSpot properties. Custom properties are auto-detected.

HubSpot API Scopes Required

crm.objects.contacts, crm.objects.deals, timeline

Salesforce Integration

Connect Syncora to Salesforce for enterprise-grade CRM synchronization.

Create Connected App

In Salesforce Setup, create a Connected App with OAuth enabled. Set callback URL to:https://app.syncora.ai/oauth/salesforce/callback

Enter Credentials

Copy the Consumer Key and Consumer Secret to the Syncora dashboard.

Authorize & Sync

Complete OAuth flow. Syncora will sync Leads, Contacts, and create Tasks for call activities.

salesforce-sync.yamlyaml

# Salesforce Objects Synced
- Lead (bi-directional sync)
- Contact (bi-directional sync)
- Task (write-only, for call logs)
- Opportunity (optional, on qualification)
- Custom Objects (configurable)

Need Help?

Our engineering team is available for implementation support and custom integrations.

Contact Engineering System Status