---
title: "Sử dụng ThunderPhone với Zapier"
description: "Kết nối ứng dụng ThunderPhone trên Zapier với tổ chức của bạn và xây dựng Zap chạy mỗi khi cuộc gọi kết thúc."
---

[Zapier](https://zapier.com) kết nối các ứng dụng bằng quy trình tự động hóa gọi là
Zap. Ứng dụng ThunderPhone trên Zapier bổ sung:

- **Trình kích hoạt:** **Cuộc gọi hoàn tất** kích hoạt khi cuộc gọi điện thoại, web hoặc kiểm thử kết thúc.
  **Cuộc gọi được chấm điểm** kích hoạt khi có điểm của một cuộc gọi đã hoàn tất.
- **Hành động:** **Thực hiện cuộc gọi đi**, **Thêm liên hệ vào chiến dịch** và
  **Bắt đầu chiến dịch**.
- **Tìm kiếm:** **Tìm cuộc gọi** tra cứu cuộc gọi theo ID và trả về cuộc gọi cùng
  bản ghi lời thoại và URL bản ghi có chữ ký khi có.

Tìm ứng dụng tại [ThunderPhone trên Zapier](https://zapier.com/apps/thunderphone/integrations).
Để xem tổng quan về cả hai cách sử dụng Zapier với ThunderPhone, xem
[trang tích hợp Zapier](https://thunderphone.com/integrations/zapier).

## Kết nối tổ chức của bạn

Ứng dụng kết nối qua OAuth. Bạn đăng nhập vào ThunderPhone và phê duyệt
quyền truy cập cho một tổ chức mà không cần sao chép API key vào Zapier.

<Steps>
  <Step title="Thêm một bước ThunderPhone">
    Trong trình chỉnh sửa Zap, tìm **ThunderPhone** (hiển thị nhãn thử nghiệm)
    và chọn một trình kích hoạt hoặc hành động. Khi Zapier yêu cầu tài khoản, hãy kết nối một tài khoản mới. Zapier sẽ mở
    cửa sổ đăng nhập ThunderPhone.
  </Step>
  <Step title="Đăng nhập và chọn tổ chức">
    Đăng nhập, kiểm tra các quyền được yêu cầu, chọn tổ chức và
    chọn **Phê duyệt**. Ứng dụng yêu cầu quyền đọc tác nhân AI và số điện thoại của bạn,
    đọc và ghi cuộc gọi cùng chiến dịch, quản lý các tích hợp như điểm cuối webhook
    và xem email tài khoản của bạn.
  </Step>
  <Step title="Kiểm tra tên kết nối">
    Zapier đặt tên kết nối theo tổ chức bạn đã phê duyệt, để bạn
    có thể phân biệt các kết nối khi thuộc nhiều tổ chức.
  </Step>
</Steps>

Kết nối bằng tài khoản có vai trò quản trị viên hoặc chủ sở hữu trong
tổ chức đó. Việc bật hoặc tắt Zap kích hoạt và mọi hành động đều cần
vai trò này. Một Zap kích hoạt đang bật vẫn tiếp tục nhận sự kiện cuộc gọi sau khi
vai trò thay đổi hoặc kết nối bị thu hồi. Hãy tắt Zap để dừng nhận sự kiện. Tìm
cuộc gọi hoạt động với mọi thành viên.

Ứng dụng không có phí ThunderPhone riêng. Các cuộc gọi mà ứng dụng thực hiện hoặc bắt đầu
được tính phí theo mức giá ThunderPhone thông thường của bạn, còn Zapier tính số tác vụ theo
gói Zapier của bạn.

## Tạo Zap đầu tiên

Zap này thêm một hàng vào Google Sheet mỗi khi cuộc gọi kết thúc.

<Steps>
  <Step title="Thực hiện cuộc gọi để dùng làm dữ liệu mẫu">
    Mở một tác nhân trong trình tạo, nhấp vào **Trò chuyện**, rồi kết thúc cuộc gọi. Các
    cuộc gọi kiểm tra trong trình tạo sẽ kích hoạt Call Completed, vì vậy thao tác này
    cung cấp cho trình kích hoạt một cuộc gọi gần đây để tải.
  </Step>
  <Step title="Thêm trình kích hoạt">
    Chọn **ThunderPhone** làm ứng dụng kích hoạt, đặt sự kiện thành **Call
    Completed**, rồi chọn kết nối ThunderPhone của bạn. Kiểm tra trình kích hoạt.
    Zapier tải các cuộc gọi hoàn tất gần đây nhất của bạn dưới dạng mẫu, với cùng
    cấu trúc như một sự kiện trực tiếp.
  </Step>
  <Step title="Thêm Google Sheets">
    Thêm một hành động Google Sheets tạo hàng trong bảng tính. Chọn một trang tính
    có hàng tiêu đề, rồi ánh xạ từng cột với một trường từ trình kích hoạt (xem
    bảng bên dưới).
  </Step>
  <Step title="Xuất bản Zap">
    Xuất bản và bật Zap. Việc bật Zap sẽ tạo một endpoint webhook trong tổ chức
    ThunderPhone của bạn có tên **Zapier: Call Completed**. Việc tắt Zap sẽ xóa
    endpoint đó.
  </Step>
  <Step title="Kiểm tra">
    Thực hiện một cuộc gọi kiểm tra khác trong trình tạo. Khi cuộc gọi kết thúc,
    Zap sẽ chạy và một hàng sẽ xuất hiện.
  </Step>
</Steps>

Các cột hữu ích:

| Cột | Trường Call Completed |
|---|---|
| ID cuộc gọi | ID cuộc gọi |
| Tác nhân | Tên tác nhân |
| Hướng cuộc gọi | Hướng cuộc gọi |
| Từ | Số gọi đi |
| Đến | Số gọi đến |
| Bắt đầu | Thời điểm bắt đầu |
| Kết thúc | Thời điểm kết thúc |
| Thời lượng (giây) | Thời lượng tính bằng giây |
| Trạng thái | Trạng thái |
| Lý do kết thúc | Lý do kết thúc |
| Liên kết cuộc gọi | Nhập `https://app.thunderphone.com/dashboard/call-history/`, rồi chèn ID cuộc gọi |

Liên kết cuộc gọi sẽ mở cuộc gọi trong bảng điều khiển ThunderPhone dành cho
thành viên trong tổ chức của bạn, kèm bản chép lời và bản ghi âm, do đó bảng
tính không cần lưu cả hai.

Sự kiện cũng có thể chứa bản chép lời dưới dạng danh sách lượt hội thoại và
URL bản ghi âm, một liên kết đã ký có thời hạn. Chỉ thêm chúng nếu bảng tính
cần. Bản chép lời, bản tóm tắt và bản ghi âm cuộc gọi có thể chứa thông tin cá
nhân hoặc thông tin sức khỏe. Chỉ gửi chúng đến các ứng dụng mà tổ chức của bạn
được phép sử dụng cho dữ liệu đó, theo BAA khi có thông tin sức khỏe liên quan,
và chỉ lưu các trường bạn cần. Xem
[`telephony.complete` / `web.complete`](/vi/webhooks/call-complete) để biết mọi
trường.

<Note>
  Mỗi lần gửi đều được ký. Ứng dụng kiểm tra HMAC `X-ThunderPhone-Signature`
  với bí mật của endpoint trước khi Zap chạy và dừng đối với mọi nội dung không
  được ký hoặc không hợp lệ. Nếu Zapier không chấp nhận một lần gửi,
  ThunderPhone sẽ thử lại trong tối đa 24 giờ. Xem [Tổng quan về webhook](/vi/webhooks/overview).
</Note>

## Trình kích hoạt, hành động và tìm kiếm

**Cuộc gọi đã chấm điểm** cung cấp ID Cuộc gọi, ID Tác nhân, Tên tác nhân và thông tin chấm điểm: ID Chấm điểm, Điểm số, Kết quả cuộc gọi, Tóm tắt, Mô hình chấm điểm và Thời điểm chấm điểm. Bật Zap sẽ tạo một endpoint có tên **Zapier: Cuộc gọi đã chấm điểm**. Một cuộc gọi có thể được chấm điểm nhiều lần và mỗi lần chấm điểm hoàn tất sẽ kích hoạt trình kích hoạt. Xem
[`call.graded`](/vi/webhooks/events).

**Tìm cuộc gọi** nhận ID Cuộc gọi, kèm danh sách thả xuống các cuộc gọi gần đây. Hành động này trả về tác nhân AI của cuộc gọi, hướng gọi, số điện thoại, thời gian bắt đầu và kết thúc, trạng thái, lý do kết thúc, điểm chấm và kết quả cuộc gọi, bản ghi lời thoại, cùng URL bản ghi có chữ ký khi có sẵn. ID Cuộc gọi không xác định sẽ không trả về kết quả thay vì báo lỗi.

**Thực hiện cuộc gọi đi** nhận:

| Trường | Ý nghĩa |
|---|---|
| Tác nhân | Một tác nhân AI đã lưu. Danh sách thả xuống liệt kê các tác nhân AI của bạn. |
| Số đến | Số đích ở định dạng E.164, chẳng hạn như `+14155552671`. |
| Số gọi đi | Danh sách thả xuống chỉ liệt kê các số đã bật cho cuộc gọi đi. |
| Biến | Đối tượng JSON tùy chọn chứa các giá trị cho placeholder trong prompt của tác nhân AI. |
| Khóa idempotency | ID ổn định từ trình kích hoạt hoặc bản ghi nguồn. Bắt buộc. |

Hành động này trả về ID Cuộc gọi, Trạng thái và Phát lại idempotent.

**Thêm liên hệ vào chiến dịch** thêm liên hệ vào một chiến dịch nháp. Với một liên hệ, điền **Số điện thoại** ở định dạng E.164 và tùy chọn **Biến liên hệ**, một đối tượng JSON có các thuộc tính trở thành biến chiến dịch. Với một lô, điền **JSON liên hệ** bằng một mảng chứa tối đa 5.000 đối tượng. Mỗi đối tượng cần có `phone_number`, còn các thuộc tính khác của đối tượng sẽ trở thành biến. Bước này thất bại khi mọi liên hệ đều bị từ chối và đặt **Thành công một phần** khi chỉ một số liên hệ bị từ chối.

**Bắt đầu chiến dịch** bắt đầu hoặc tiếp tục một chiến dịch có ít nhất một liên hệ. Hành động này yêu cầu **Đồng ý tính phí**. Xem
[Chiến dịch gọi đi](/vi/guides/outbound-campaigns).

## Trước khi Zap thực hiện cuộc gọi

Thực hiện cuộc gọi đi và Bắt đầu chiến dịch quay số điện thoại thực và bắt đầu các cuộc gọi tính phí.

- Nếu ThunderPhone yêu cầu tổ chức của bạn xác nhận rằng các cuộc gọi đi của tổ chức tuân thủ TCPA và các luật gọi điện khác, quản trị viên phải ghi nhận xác nhận đó trong bảng điều khiển trước khi Zap có thể bắt đầu cuộc gọi.
- Số gọi đi phải được bật cho cuộc gọi đi. Các số bạn mang từ nhà cung cấp của riêng mình đủ điều kiện sau khi được xác minh. Các số do ThunderPhone cung cấp ban đầu chỉ nhận cuộc gọi đến, và bạn có thể yêu cầu quyền gọi đi cho các số đó trong bảng điều khiển. Xem [Lấy số điện thoại](/vi/guides/get-a-phone-number).
- Thực hiện cuộc gọi đi yêu cầu **Khóa idempotency**. Ánh xạ một ID ổn định từ trình kích hoạt hoặc bản ghi nguồn, chẳng hạn như ID sự kiện ThunderPhone hoặc ID bản ghi CRM. Nếu Zapier thử lại bước này, ThunderPhone nhận diện khóa và trả về cuộc gọi gốc thay vì thực hiện cuộc gọi thứ hai. Tránh dùng dấu thời gian, giá trị ngẫu nhiên hoặc chỉ riêng ID Zap.
- Bắt đầu chiến dịch yêu cầu **Đồng ý tính phí**, xác nhận rằng Zap có thể bắt đầu các cuộc gọi đi tính phí trên tài khoản của bạn.
- Tổ chức của bạn có trách nhiệm có sự đồng ý để gọi đến từng số và tuân thủ các luật gọi điện hiện hành. Xem
[luật gọi đi](/vi/guides/outbound-calling-laws).

Khóa idempotency là duy nhất trong toàn tổ chức của bạn và có tối đa 128 ký tự. Dùng lại một khóa với tác nhân AI, số điện thoại hoặc biến khác sẽ thất bại do xung đột, vì vậy nếu hai Zap có thể gọi về cùng một bản ghi, hãy đặt cho mỗi Zap tiền tố cố định riêng trước ID bản ghi.
[Thực hiện cuộc gọi đi](/vi/guides/place-outbound-calls) trình bày API phía sau hành động này.

## Ví dụ về Zap

- **Cuộc gọi hoàn tất đến CRM.** Ghi lại một hoạt động cho mỗi cuộc gọi đã
  hoàn tất, kèm trạng thái, lý do kết thúc và bản chép lời.
- **Cuộc gọi được chấm điểm để theo dõi.** Lọc theo kết quả hoặc điểm cuộc gọi
  và chuyển cuộc gọi vào quy trình theo dõi phù hợp.
- **Khách hàng tiềm năng mới đến chiến dịch.** Thêm khách hàng tiềm năng vào
  chiến dịch nháp bằng Thêm liên hệ vào chiến dịch, sau đó chạy Bắt đầu chiến
  dịch khi có người phê duyệt danh sách.

Bản chép lời, bản tóm tắt và bản ghi âm cuộc gọi có thể chứa thông tin cá
nhân hoặc thông tin sức khỏe. Chỉ gửi chúng đến các ứng dụng mà tổ chức của
bạn được phép sử dụng cho dữ liệu đó, theo BAA khi có liên quan đến thông tin
sức khỏe, và chỉ giữ lại các trường bạn cần.

## Khắc phục sự cố

**Một bước gặp lỗi ủy quyền.** Kết nối lại kết nối ThunderPhone trong Zapier
và phê duyệt lại. Kết nối sẽ ngừng hoạt động khi người đã kết nối thu hồi nó
trong ThunderPhone tại **Tổ chức → Khóa → Ứng dụng được ủy quyền**, khi người
đó rời khỏi tổ chức, hoặc khi quá 30 ngày mà không làm mới token thành công.
Xem [Kết nối bằng OAuth](/vi/guides/oauth).

**Không thể bật hoặc tắt Zap, hoặc một hành động bị từ chối.** Người đã kết
nối cần có vai trò quản trị viên hoặc chủ sở hữu trong tổ chức. Kết nối lại
bằng một tài khoản có vai trò đó. Một Zap kích hoạt đã bật vẫn tiếp tục nhận
sự kiện cuộc gọi sau khi vai trò thay đổi hoặc kết nối bị thu hồi. Tắt Zap để
dừng chúng.

**Bạn muốn ngắt kết nối ứng dụng.** Tắt các Zap ThunderPhone trước khi thu hồi
kết nối, vì việc tắt Zap sẽ xóa endpoint của nó và cần một kết nối đang hoạt
động. Nếu bạn đã thu hồi trước, hãy xóa endpoint **Zapier: …** còn lại bằng
`DELETE /v1/developer/webhook-endpoints/{id}` bằng khóa API quản trị viên. Xem
[Webhook endpoint](/vi/webhooks/endpoints).

**Zap cần sử dụng một tổ chức khác.** Mỗi kết nối chỉ bao gồm một tổ chức. Hãy
tắt Zap trước để webhook endpoint của nó được xóa khỏi tổ chức hiện tại. Sau
đó, kết nối một tài khoản ThunderPhone mới trong Zapier, chọn tổ chức khác khi
bạn phê duyệt và chọn kết nối đó ở mỗi bước ThunderPhone. Tác nhân AI, số điện
thoại và chiến dịch khác nhau giữa các tổ chức, vì vậy hãy chọn lại
**Tác nhân**, **Số gọi đi** và **Chiến dịch** tại mỗi bước có các mục này. Sau
đó bật lại Zap.

**Kích hoạt đã ngừng chạy.** Mỗi Zap có kích hoạt ThunderPhone sở hữu một
webhook endpoint trong tổ chức của bạn, có tên **Zapier: Call Completed** hoặc
**Zapier: Call Graded**. Endpoint này được tạo khi Zap bật và bị xóa khi Zap
tắt. Hãy giữ nguyên như vậy. Nếu endpoint đã bị chỉnh sửa hoặc xóa trong
ThunderPhone, hãy tắt rồi bật lại Zap để tạo endpoint mới.
Với khóa API quản trị viên,
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
hiển thị các lần thử gửi gần đây.

<Note>
  Muốn tác nhân AI sử dụng các hành động Zapier trong cuộc gọi thay vì sau đó?
  Kết nối một endpoint MCP Zapier tại **Kết nối → MCP**. Xem
  [Máy chủ MCP](/vi/guides/mcp-servers). Để gửi cùng các sự kiện cuộc gọi đó đến
  máy chủ của riêng bạn, xem [Webhook endpoint](/vi/webhooks/endpoints).
</Note>