API المكالمات الهاتفية بالذكاء الاصطناعي: أجرِ مكالمات حقيقية ورُدّ عليها بوكيل ذكاء اصطناعي

ما API المكالمات الهاتفية بالذكاء الاصطناعي من Wixzel Voice؟

كيف تجري مكالمة هاتفية بالذكاء الاصطناعي باستخدام Wixzel Voice؟

1. 01

   اربط SIP trunk الخاص بك

   مضيف مزوّد الاتصالات وبيانات الاعتماد. كلمة المرور مشفّرة في حالة التخزين ولا تُعاد مرة أخرى أبدًا. تحمل الاستجابة platform_ip (حاليًا 187.126.120.231)، الذي يجب أن يضيفه مزوّد الاتصالات إلى قائمة السماح، وorigination_uri (حاليًا sip:187.126.120.231:5090)، وهو المكان الذي يرسل إليه مزوّد الاتصالات المكالمات الواردة.

   cURLنسخ

   curl https://api.voice.wixzel.com/v1/sip-trunks \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "My carrier",
       "host": "sip.carrier.example",
       "username": "acct123",
       "password": "..."
     }'

2. 02

   سجّل رقم هاتف عليه

   رقم تملكه بالفعل لدى مزوّد الاتصالات ذاك، بصيغة E.164. لا يبيع Wixzel Voice الأرقام ولا ينقلها. إذا كان الـ trunk مرتبطًا بحسابك في Twilio أو Telnyx أو Plivo أو Vobiz أو Vonage، فيمكنك بدلًا من ذلك شراء رقم جديد على ذلك الحساب باستخدام POST /v1/phone-numbers/purchase. ويحاسبك مزوّد الاتصالات عليه بسعره.

   cURLنسخ

   curl https://api.voice.wixzel.com/v1/phone-numbers \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "phone_number": "+14155550100",
       "sip_trunk_id": "'"$TRUNK_ID"'"
     }'

3. 03

   أنشئ وكيلًا

   تعليمات قصيرة بأسلوب الكلام المنطوق، وأول ما يقوله، وصوت: ثلاثة نماذج، أو نموذج فوري واحد. الحقل opening_message مطلوب، لأن الوكيل الذي ليس له رسالة افتتاحية يرد بالصمت. ويجعل outbound_phone_number_id الرقمَ من الخطوة 2 معرّف المتصل الخاص به.

   cURLنسخ

   curl https://api.voice.wixzel.com/v1/agents \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Support",
       "system_prompt": "You are a concise support agent.",
       "opening_message": "Hi, how can I help?",
       "voice": {
         "stt": { "model": "deepgram/nova-3" },
         "llm": { "model": "openrouter/gpt-4o-mini" },
         "tts": { "model": "elevenlabs/eleven_flash_v2_5" }
       },
       "outbound_phone_number_id": "'"$NUMBER_ID"'"
     }'

4. 04

   أجرِ المكالمة

   وجهة ووكيل. الترويسة Idempotency-Key مطلوبة، لأن انتهاء مهلة الشبكة لا يخبرك بشيء عمّا إذا كانت المكالمة قد أُجريت: إعادة المحاولة بالمفتاح نفسه تعيد المكالمة الأصلية بدل الاتصال مرتين. الاستجابة 201 مع المكالمة، وstatus: "queued".

   cURLنسخ

   curl https://api.voice.wixzel.com/v1/calls \
     -H "Authorization: Bearer $WIXZEL_API_KEY" \
     -H "Idempotency-Key: $(uuidgen)" \
     -H "Content-Type: application/json" \
     -d '{
       "to": "+14155551234",
       "agent_id": "'"$AGENT_ID"'"
     }'

قبل أن تتصل المكالمة الأولى، يجب أن يضيف مزوّد الاتصالات platform_ip إلى قائمة السماح. تبيّن أدلة مزوّدي الاتصالات مكان هذا الإعداد لدى Twilio, Telnyx, Plivo, Vonage, Bandwidth, Exotel, Vobiz, Mobily.

كيف تجري مكالمة هاتفية بالذكاء الاصطناعي من TypeScript أو Dart؟

import { WixzelVoice } from 'wixzel-voice';

const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY! });

// 1. Connect your SIP trunk.
const trunk = await client.sipTrunks.create({
  name: 'My carrier',
  host: 'sip.carrier.example',
  username: 'acct123',
  password: process.env.CARRIER_PASSWORD!,
});
console.log('Allowlist', trunk.platform_ip, 'and send inbound calls to', trunk.origination_uri);

// 2. Register a number you own on it.
const number = await client.phoneNumbers.create({
  phone_number: '+14155550100',
  sip_trunk_id: trunk.id,
});

// 3. Create the agent, with that number as its caller ID.
const agent = await client.agents.create({
  name: 'Support',
  system_prompt: 'You are a concise support agent.',
  opening_message: 'Hi, how can I help?',
  voice: {
    stt: { model: 'deepgram/nova-3' },
    llm: { model: 'openrouter/gpt-4o-mini' },
    tts: { model: 'elevenlabs/eleven_flash_v2_5' },
  },
  outbound_phone_number_id: number.id,
});

// 4. Place the call. The SDK sends the Idempotency-Key for you.
const call = await client.calls.create({ to: '+14155551234', agent_id: agent.id });

// Inbound: calls to the number are answered by the same agent.
await client.phoneNumbers.update(number.id, { inbound_agent_id: agent.id });

// Later: what happened, what it cost, what was said.
const detail = await client.calls.retrieve(call.id);
console.log(detail.status, detail.cost_micros, detail.failure_code, detail.failure_reason);
for (const line of detail.transcript) console.log(line.role, line.content);

import 'dart:io';

import 'package:wixzel_voice/wixzel_voice.dart';

Future<void> main() async {
  final client = WixzelVoice(apiKey: Platform.environment['WIXZEL_API_KEY']!);

  // 1. Connect your SIP trunk.
  final trunk = await client.sipTrunks.create(CreateSipTrunk(
    name: 'My carrier',
    host: 'sip.carrier.example',
    username: 'acct123',
    password: Platform.environment['CARRIER_PASSWORD']!,
  ));
  print('Allowlist ${trunk.platformIp}; send inbound calls to ${trunk.originationUri}');

  // 2. Register a number you own on it.
  final number = await client.phoneNumbers.create(CreatePhoneNumber(
    phoneNumber: '+14155550100',
    sipTrunkId: trunk.id,
  ));

  // 3. Create the agent, with that number as its caller ID.
  final agent = await client.agents.create(CreateAgent(
    name: 'Support',
    systemPrompt: 'You are a concise support agent.',
    openingMessage: 'Hi, how can I help?',
    voice: VoiceConfig.composed(
      stt: const SttConfig(model: 'deepgram/nova-3'),
      llm: const LlmConfig(model: 'openrouter/gpt-4o-mini'),
      tts: const TtsConfig(model: 'elevenlabs/eleven_flash_v2_5'),
    ),
    outboundPhoneNumberId: number.id,
  ));

  // 4. Place the call. The SDK sends the Idempotency-Key for you.
  final call = await client.calls.create(CreateCall(
    to: '+14155551234',
    agentId: agent.id,
  ));

  // Inbound: calls to the number are answered by the same agent.
  await client.phoneNumbers.update(
      number.id, UpdatePhoneNumber(inboundAgentId: agent.id));

  // Later: what happened, what it cost, what was said.
  final detail = await client.calls.retrieve(call.id);
  print('${detail.status} ${detail.costMicros} ${detail.failureCode}');
  for (final line in detail.transcript) {
    print('${line.role}: ${line.content}');
  }
  client.close();
}

كيف يرد وكيل الذكاء الاصطناعي على المكالمات الواردة في Wixzel Voice؟

curl -X PATCH https://api.voice.wixzel.com/v1/phone-numbers/$NUMBER_ID \
  -H "Authorization: Bearer $WIXZEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "inbound_agent_id": "'"$AGENT_ID"'" }'

ماذا يعيد سجل المكالمة في Wixzel Voice؟

ماذا يحدث عندما لا تتصل مكالمة هاتفية بالذكاء الاصطناعي؟

كم تكلّف المكالمة الهاتفية بالذكاء الاصطناعي على Wixzel Voice؟

مسبق الدفع: أضف رصيدًا بدءًا من $5، بلا اشتراك وبلا باقة مجانية. أرخص محرك اليوم هو gemini-live بسعر $0.0491 في الدقيقة. قدّر مزيج استخدامك.

ما حدود API المكالمات الهاتفية بالذكاء الاصطناعي من Wixzel Voice؟

• Wixzel Voice منشور ويستقبل مكالمات حقيقية. تُطرح التغييرات السلوكية خلف ترويسة Wixzel-Version مؤرخة، ويحتفظ كل مفتاح موجود بالسلوك الذي أُنشئ عليه.
• خمس مكالمات متزامنة لكل حساب افتراضيًا، ويُرفع الحد عند الطلب. وتُحسب جلسات الويب والتطبيقات ضمن الحد نفسه.
• التحويل إلى شخص تحويل مباشر فقط: يُسلَّم المتصل مباشرة إلى رقم حددته. التحويل بعد التمهيد غير مبني، والتحويل غير متاح في مكالمات الاختبار ولا في جلسات الويب أو التطبيقات.
• لا يبيع Wixzel Voice أرقام الهاتف ولا ينقلها، والمكالمات الهاتفية تحتاج إلى SIP trunk خاص بك. ويمكنه شراء رقم لك على حسابك الخاص في Twilio أو Telnyx أو Plivo أو Vobiz أو Vonage، ويحاسبك عليه مزوّد الاتصالات.
• تنقل جلسات الويب والتطبيقات صوتًا بترميز G.711 µ-law بتردد 8 kHz، وهي جودة الهاتف وليست نطاقًا عريضًا.
• 10 طلبات API في الثانية لكل مفتاح، مع دفعة قصوى قدرها 20. الطلب الذي يتجاوز حد المعدل لا يُحتسب أبدًا.
• يقع API والبيانات المخزنة في مومباي بالهند. يعالج مزوّدو الكلام واللغة في الولايات المتحدة والهند الصوت والنص طوال مدة المكالمة؛ ويعالج محرك sarvam الكلام في الهند.
• لا باقة مجانية ولا رصيد تجريبي. الحد الأدنى للشحن $5. الاستخدام المجاني الوحيد هو 5 دقائق لكل حساب للتحدث إلى وكلائك من لوحة التحكم.

إلى أين بعد ذلك