Connect Nutshell to IntelDialix voice agents

How it works

How information moves between a live phone call and Nutshell.

1. 01

   A call reaches your agent

   A caller dials a Twilio or SIP number assigned to the agent, or the agent places an outbound call from a campaign.

   Twilio / SIP number → IntelDialix agent

2. 02

   The agent uses Nutshell mid-call

   When the conversation needs data, the agent runs a custom tool: an HTTP request to Nutshell with the details it has collected.

   Custom tool → Nutshell JSON-RPC API

3. 03

   The call ends with a record

   IntelDialix keeps the recording, transcript and post-call analysis for the conversation in your call history.

   Recording · transcript · analysis

4. 04

   Nutshell receives the result

   A signed webhook delivers the call event to your Nutshell endpoint, and is retried automatically if the delivery fails.

   HTTPS POST · X-Dialix-Signature

At a glance

Key figures

Voice engines

ElevenLabs · Vapi · Gemini

Choose the engine per agent and compare them on real calls.

Telephony

Twilio & SIP

Use numbers you already have, for inbound and outbound calls.

Call events

Signed webhooks

HMAC-SHA256 signature on every delivery, retried on failure.

Starter plan

$14 / month

One agent, one number and 100 calls a month.

Example

// Verify an IntelDialix webhook before trusting it in Nutshell.
// Header: X-Dialix-Signature: t=<unix seconds>,v1=<hex>
// where v1 = HMAC-SHA256(secret, "<t>.<raw request body>")
import crypto from 'node:crypto';

export function verifyDialixWebhook(rawBody, signatureHeader, secret) {
  const parts = Object.fromEntries(
    signatureHeader.split(',').map((kv) => kv.split('='))
  );
  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${parts.t}.${rawBody}`)
    .digest('hex');
  const valid =
    typeof parts.v1 === 'string' &&
    parts.v1.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected));
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  return valid && fresh;
}

// Body: { "event": "call.completed", "payload": { ... }, "timestamp": "..." }

Check the signature before acting on an event in Nutshell. The secret is the one you set when you add the webhook in IntelDialix settings.

FAQ

Frequently asked questions

Keep exploring

Related pages

• templateNutshell Small Business Phone ReceptionistCapture customer inquiries and create new lead records in Nutshell CRM automatically.
• integrationCopper Voice AI IntegrationLog call summaries and sync Google Calendar follow-ups directly from IntelDialix phone agent conversations.
• integrationInsightly Voice AI IntegrationConnect customer onboarding phone calls to Insightly project milestones and task completion.
• integrationSalesforce Voice AI IntegrationAutomatic caller contact identification, real-time opportunity creation, and synchronized call audio logging.
• integrationHubSpot Voice AI IntegrationTwo-way contact enrichment, automated deal stage progression, and instant call recording attachment.
• integrationZendesk Voice AI IntegrationAutomatically open tickets, log verbatim transcripts, and route unresolved caller escalations to human tiers.