Sử dụng ThunderPhone với Zapier

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 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. Để xem tổng quan về cả hai cách sử dụng Zapier với ThunderPhone, xem trang tích hợp 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.

1. 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.

2. Đă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.

3. 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.

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.

1. 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.

2. 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.

3. 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).

4. 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 đó.

5. 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.

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

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 để biết mọi trường.

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.

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:

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.

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.
• 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.

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 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.

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.

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 hiển thị các lần thử gửi gần đây.