用 Wixzel Voice 執行 AI 潛在客戶篩選活動

開始之前需要準備什麼？

• 一個 SIP 中繼，以及登記在其上的外撥號碼。Twilio 指南和 SIP 中繼文件都有說明。
• 一把有點數的 Wixzel Voice API 金鑰，以及 Node.js 20 或更新版本，並執行 npm install wixzel-voice。
• 在法律要求的情況下，取得名單上每位潛在客戶的通話同意。下方的法規遵循步驟摘要說明了可接受使用政策的要求。

如何在 Wixzel Voice 上逐步打造？

1. 01撰寫撥話代理

   代理就是腳本。合併欄位讓每通電話都個人化：

   agent.mjs複製

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   const agent = await client.agents.create({
     name: 'Demo follow-up',
     outbound_phone_number_id: process.env.NUMBER_ID,
     system_prompt: [
       'You are calling {{name}} from {{company}}, who asked for a demo of Acme Scheduling.',
       'Ask three questions, one at a time: how many staff take bookings,',
       'what they use for bookings today, and when they would want to switch.',
       'Keep replies short. If they are not interested, thank them and end the call.',
       'If they ask not to be called again, confirm that you have noted it and end the call.',
       'Finish by thanking them and saying a person will follow up by email.',
     ].join('\n'),
     opening_message: 'Hi {{name}}, this is an automated assistant calling for Acme about the demo you requested. Is now a good time?',
     voice: {
       stt: { model: 'deepgram/nova-3', language: 'en-US' },
       llm: { model: 'openrouter/gpt-4o-mini' },
       tts: { model: 'elevenlabs/eleven_flash_v2_5' },
     },
   });
   
   console.log('AGENT_ID', agent.id);

   {{name}} 取自潛在客戶，潛在客戶 fields 中的每個鍵也都會成為合併欄位，因此 {{company}} 來自下方的上傳資料。開場白說明來電者是自動系統，若法律要求揭露，就應放在這裡。活動必須設定 outbound_phone_number_id：它是每通電話顯示的來電號碼。

2. 02上傳潛在客戶

   其餘的建置都在同一個腳本 campaign.mjs 中，從上傳開始：

   campaign.mjs, part 1複製

   import { WixzelVoice } from 'wixzel-voice';
   
   const client = new WixzelVoice({ apiKey: process.env.WIXZEL_API_KEY });
   
   // From your CRM or a CSV: only people you have consent to call.
   const rows = [
     { name: 'Priya Nair', phone_number: '+14155550111', fields: { company: 'Northside Physio' } },
     { name: 'Sam Carter', phone_number: '+14155550112', fields: { company: 'Carter Auto' } },
   ];
   
   const upload = await client.leads.bulkCreate({ leads: rows });
   console.log('created', upload.created_count, 'failed', upload.failed_count);
   for (const e of upload.errors) console.log('row', e.index, e.phone_number, e.error);
   
   const leadIds = upload.data.map((lead) => lead.id);

   單一請求最多可上傳 1,000 位潛在客戶。資料列會逐一驗證，因此請檢查 failed_count 和 errors，不要假設整份名單都已上傳。批次上傳不會觸發任何 webhook。

3. 03依同時通話上限分批執行活動

   一個活動就是一個代理加上一份潛在客戶名單。建立活動不會撥打任何電話；start 才會，並在每通電話接通時消耗點數。

   目前活動會連續快速撥出電話，而不是排隊等候，且每通電話都計入帳號的同時通話上限（預設五通）。超出上限的潛在客戶會被記錄為失敗的通話，而不會等候輪到它。因此請以不超過上限的批次執行名單，並在上一批結束後再開始下一批：

   campaign.mjs, part 2複製

   const LIMIT = 5; // your account's concurrent-call limit, minus any calls you expect meanwhile
   const DONE = new Set(['completed', 'failed', 'busy', 'no-answer', 'canceled']);
   const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
   
   async function finishedCalls(campaignId) {
     let finished = 0;
     for await (const call of await client.calls.list({ campaign_id: campaignId, limit: 100 })) {
       if (DONE.has(call.status)) finished++;
     }
     return finished;
   }
   
   const campaignIds = [];
   for (let i = 0; i < leadIds.length; i += LIMIT) {
     const batch = leadIds.slice(i, i + LIMIT);
     const campaign = await client.campaigns.create({
       name: 'Demo follow-up ' + (i / LIMIT + 1),
       agent_id: process.env.AGENT_ID,
       lead_ids: batch,
     });
     await client.campaigns.start(campaign.id);
     campaignIds.push(campaign.id);
   
     const giveUpAt = Date.now() + 30 * 60 * 1000;
     while ((await finishedCalls(campaign.id)) < batch.length && Date.now() < giveUpAt) {
       await sleep(15000);
     }
   }

   start 回應的活動狀態為 status: "running"。若要提前停止某一批，client.campaigns.pause(campaign.id) 會停止活動並掛斷進行中的通話，之後活動狀態為 status: "stopped"。再次啟動已停止的活動會重新撥打其中每位潛在客戶，包括已撥過的，所以若要繼續，請用尚未聯繫到的潛在客戶建立新活動。建立時設定 scheduled_at，活動就會在指定時間開始，而不是在 start 時開始。

4. 04讀回每通電話

   每通電話都是一筆紀錄，包含狀態、費用和逐字稿，並以 lead_id 連結到潛在客戶：

   campaign.mjs, part 3複製

   for (const campaignId of campaignIds) {
     for await (const call of await client.calls.list({ campaign_id: campaignId, limit: 100 })) {
       const detail = await client.calls.retrieve(call.id);
       const answers = detail.transcript
         .filter((line) => line.role === 'user')
         .map((line) => line.content)
         .join(' / ');
       console.log(call.lead_id, call.status, call.duration_seconds, call.failure_code, answers);
     }
   }

   status 表示通話是否接通，failure_code 說明未接通的原因（17 忙線、19 無人接聽、21 遭電信業者拒絕），cost_micros 則是費用。在撥號前因同時通話上限或點數不足而被拒絕的潛在客戶，會顯示為 failed 且沒有 failure_code。

   篩選結果由您判斷。Wixzel Voice 會記錄對話；逐字稿包含三個問題的答案，請用您自己的規則或模型評分，並將結果寫入您的 CRM。summary 欄位可能是空的，請不要依賴它。若想在通話結束時即時處理而不是輪詢，請訂閱 callCompleted webhook，它會帶有潛在客戶和活動的 id，以及通話的狀態和時長。

5. 05遵守通話規範

   可接受使用政策將以下責任歸於撥話方，也就是您。以下是該政策的摘要，並非法律建議。

   在法律要求的情況下，只撥打給已取得同意的人。在美國，依 TCPA 規定，對手機號碼撥打行銷電話通常需要事先取得明確的書面同意；在印度，適用 TRAI 的客戶偏好規範；在英國和歐盟，則適用 PECR 和 GDPR。

   每次上傳前，請比對國家及州級的拒接來電登記名單，以及您自己的排除名單。當有人要求不要再來電時，請立即且永久地移除：代理可以禮貌地結束通話，但移除潛在客戶是您程式碼的工作。

   在法律要求時，於通話開始時說明來電者是自動系統（如上方的開場白），遵守通話時段限制，並依法律要求的期間保存同意的證明。

在 Wixzel Voice 上打造這個要花多少錢？

這個實作適用哪些 Wixzel Voice 限制？

• 活動會連續快速撥打潛在客戶，不會在同時通話上限（每個帳號預設五通）之後排隊；超出的潛在客戶會被記錄為失敗。請依上限分批，或申請提高上限。
• 再次啟動已停止的活動會重新撥打其中每位潛在客戶。請用尚未聯繫到的潛在客戶建立新活動來繼續。
• 每個活動最多可包含 10,000 位潛在客戶，每個帳號預設最多 500 個活動，可申請提高。
• Wixzel Voice 會記錄通話和逐字稿。判斷誰符合資格，以及維護您的拒接來電名單，是您程式碼的工作。
• Wixzel Voice 的行為變更一律透過附日期的 Wixzel-Version 標頭推出。