Net2Phone Voice AI Pipeline
Inbound call handler — caller type detection → partner verify → address qualify → SMS result
Webhook URL
— configure this in Net2Phone Virtual Agent settingshttps://marlinnetworks.com/api/voice/inbound• Method: POST · Content-Type: application/json
• No authentication required (Net2Phone calls this from their servers)
• Returns JSON with message (agent speech) and nextStep
Pipeline Steps
Caller Type Detection
Auto-identifies if caller is a Marlin partner (by phone number lookup) or a new prospect.
Partner ID Verify
Partners say their MN-XXXX code or are matched by caller ID. Prospects skip to address collection.
Address Qualify
Caller speaks the service address. Checked against Marlin's address lookup cache first, then queued for Scout.
SMS Result
Serviceability summary sent via SMS to the caller's mobile. Address queued in admin lookup queue for follow-up.
Webhook Payload Schema
Request (Net2Phone → Marlin)
{
"callId": "string",
"callerNumber": "+15615551234",
"callerName": "string?",
"step": "identify" |
"partner_verify" |
"address_collect" |
"qualify",
"input": "speech-to-text",
"partnerCode": "MN-XXXX?",
"address": "string?"
}Response (Marlin → Net2Phone)
{
"message": "What the agent says",
"nextStep": "address_collect",
"smsSent": true,
"data": {
"callerType": "partner",
"partnerCode": "MN-0042",
"address": "123 Main St..."
}
}