Zapier에서 ThunderPhone 사용

Zapier의 ThunderPhone 앱을 조직에 연결하고 통화가 종료될 때마다 실행되는 Zap을 구축합니다.

Zapier는 Zaps라는 자동화 워크플로로 앱을 연결합니다. Zapier의 ThunderPhone 앱은 다음을 제공합니다.

• 트리거: 통화 완료는 전화, 웹 또는 테스트 통화가 종료되면 실행됩니다. 통화 평가 완료는 완료된 통화의 평가 결과를 사용할 수 있게 되면 실행됩니다.
• 작업: 발신 통화 걸기, 캠페인에 연락처 추가, 캠페인 시작.
• 검색: 통화 찾기는 ID로 통화를 조회하고, 사용 가능한 경우 대화 내용과 서명된 녹음 URL을 함께 반환합니다.

Zapier의 ThunderPhone에서 찾을 수 있습니다. Zapier를 ThunderPhone과 함께 사용하는 두 가지 방법의 개요는 Zapier 통합 페이지를 참조하세요.

조직 연결#

이 앱은 OAuth를 통해 연결됩니다. ThunderPhone에 로그인하여 하나의 조직에 대한 액세스를 승인하면 API 키가 Zapier에 복사되지 않습니다.

1. ThunderPhone 단계 추가

   Zap 편집기에서 ThunderPhone(베타 라벨로 표시됨)을 검색하고 트리거나 작업을 선택합니다. Zapier에서 계정을 요청하면 새 계정을 연결합니다. Zapier가 ThunderPhone 로그인 창을 엽니다.

2. 로그인하고 조직 선택

   로그인하고, 요청된 권한을 확인하고, 조직을 선택한 다음 승인을 선택합니다. 앱은 에이전트와 전화번호 읽기, 통화와 캠페인 읽기 및 쓰기, 웹훅 엔드포인트 등의 통합 관리, 계정 이메일 확인 권한을 요청합니다.

3. 연결 이름 확인

   Zapier는 승인한 조직 이름을 연결 이름으로 사용하므로, 둘 이상의 조직에 속한 경우 연결을 구분할 수 있습니다.

해당 조직에서 관리자 또는 소유자 역할을 가진 계정으로 연결하세요. 트리거 Zap을 켜거나 끄는 작업과 모든 작업에는 해당 역할이 필요합니다. 이미 켜져 있는 트리거 Zap은 역할이 변경되거나 연결이 해지된 후에도 통화 이벤트를 계속 수신합니다. 수신을 중지하려면 끄세요. 통화 찾기는 모든 구성원이 사용할 수 있습니다.

이 앱 자체에는 ThunderPhone 요금이 없습니다. 앱을 통해 발신하거나 시작하는 통화에는 일반 ThunderPhone 요금이 청구되며, Zapier는 Zapier 요금제에서 작업을 계산합니다.

첫 번째 Zap 만들기#

이 Zap은 통화가 종료될 때마다 Google Sheets에 행을 추가합니다.

1. 샘플 데이터로 사용할 통화 만들기

   빌더에서 에이전트를 열고 통화를 클릭한 다음 통화를 종료합니다. 빌더 테스트 통화는 통화 완료를 실행하므로, 트리거가 불러올 최근 통화를 생성할 수 있습니다.

2. 트리거 추가

   트리거 앱으로 ThunderPhone을 선택하고, 이벤트를 통화 완료로 설정한 다음 ThunderPhone 연결을 선택합니다. 트리거를 테스트합니다. Zapier는 실제 이벤트와 동일한 형식으로 가장 최근에 완료된 통화를 샘플로 불러옵니다.

3. Google Sheets 추가

   스프레드시트 행을 생성하는 Google Sheets 작업을 추가합니다. 헤더 행이 있는 시트를 선택한 다음 각 열을 트리거의 필드에 매핑합니다(아래 표 참조).

4. Zap 게시

   Zap을 게시하고 켭니다. Zap을 켜면 ThunderPhone 조직에 Zapier: 통화 완료라는 웹훅 엔드포인트가 생성됩니다. Zap을 끄면 해당 엔드포인트가 삭제됩니다.

5. 테스트

   빌더 테스트 통화를 한 번 더 만듭니다. 통화가 종료되면 Zap이 실행되고 행이 추가됩니다.

유용한 열:

통화 링크를 열면 조직 구성원이 ThunderPhone 대시보드에서 대화 내용 및 녹음과 함께 해당 통화를 볼 수 있으므로, 시트에 둘 중 어느 것도 저장할 필요가 없습니다.

이벤트에는 턴 목록 형식의 대화 내용과 만료되는 서명 링크인 녹음 URL도 포함될 수 있습니다. 시트에 필요한 경우에만 추가합니다. 통화 대화 내용, 요약 및 녹음에는 개인 정보 또는 건강 정보가 포함될 수 있습니다. 건강 정보가 포함된 경우 BAA에 따라 조직이 해당 데이터를 사용할 수 있도록 허용된 앱에만 전송하고, 필요한 필드만 유지합니다. 모든 필드는 telephony.complete / web.complete를 참조합니다.

트리거, 작업 및 검색#

통화 평가 완료는 통화 ID, 에이전트 ID, 에이전트 이름 및 평가 정보인 평가 ID, 점수, 통화 결과, 요약, 평가자 모델 및 평가 완료 시각을 제공합니다. Zap을 활성화하면 Zapier: 통화 평가 완료라는 엔드포인트가 생성됩니다. 통화는 두 번 이상 평가될 수 있으며, 완료된 각 평가 실행이 트리거를 발생시킵니다. call.graded를 참조하세요.

통화 찾기는 최근 통화 드롭다운과 함께 통화 ID를 받습니다. 에이전트, 방향, 번호, 시작 및 종료 시각, 상태, 종료 사유, 평가 점수와 통화 결과, 녹취록 및 사용할 수 있는 경우 서명된 녹음 URL을 반환합니다. 알 수 없는 통화 ID는 오류 대신 결과를 반환하지 않습니다.

발신 통화 걸기는 다음을 받습니다.

통화 ID, 상태 및 멱등성 재실행을 반환합니다.

캠페인에 연락처 추가는 초안 캠페인에 연락처를 추가합니다. 연락처 하나의 경우 전화번호에 E.164 형식의 번호를 입력하고, 선택적으로 속성이 캠페인 변수가 되는 JSON 객체인 연락처 변수를 입력합니다. 일괄 처리의 경우 최대 5,000개 객체로 구성된 배열을 연락처 JSON에 입력합니다. 각 객체에는 phone_number가 필요하며, 다른 속성은 변수가 됩니다. 모든 연락처가 거부되면 단계가 실패하며, 일부만 거부되면 부분 성공으로 설정됩니다.

캠페인 시작은 연락처가 하나 이상 있는 캠페인을 시작하거나 재개합니다. 청구 동의가 필요합니다. 발신 캠페인을 참조하세요.

Zap이 전화를 걸기 전#

발신 통화 걸기와 캠페인 시작은 실제 전화번호로 전화를 걸고 청구 가능한 통화를 시작합니다.

• ThunderPhone이 조직에 발신 통화가 TCPA 및 기타 통화 관련 법률을 준수하는지 확인하도록 요청하는 경우, Zap이 통화를 시작하기 전에 관리자가 대시보드에서 해당 확인을 기록해야 합니다.
• 발신 번호는 발신 통화에 대해 활성화되어야 합니다. 자체 통신사에서 가져온 번호는 확인이 완료되면 사용할 수 있습니다. ThunderPhone에서 제공하는 번호는 처음에는 수신 전용이며, 대시보드에서 해당 번호의 발신 액세스를 요청할 수 있습니다. 전화번호 받기를 참조하세요.
• 발신 통화 걸기에는 멱등성 키가 필요합니다. ThunderPhone 이벤트 ID 또는 CRM 레코드 ID와 같이 트리거 또는 소스 레코드의 고정 ID를 매핑하세요. Zapier가 단계를 재시도하면 ThunderPhone이 키를 인식하고 두 번째 통화를 거는 대신 원래 통화를 반환합니다. 타임스탬프, 무작위 값 또는 Zap ID만 사용하는 것은 피하세요.
• 캠페인 시작에는 청구 동의가 필요하며, 이는 Zap이 계정에서 청구 가능한 발신 통화를 시작할 수 있음을 확인합니다.
• 각 번호에 전화를 걸기 위한 동의를 확보하고 적용되는 통화 관련 법률을 준수할 책임은 조직에 있습니다. 발신 통화 관련 법률을 참조하세요.

멱등성 키는 조직 전체에서 고유해야 하며 최대 128자까지 사용할 수 있습니다. 다른 에이전트, 번호 또는 변수와 함께 키를 재사용하면 충돌로 인해 실패하므로, 두 Zap이 동일한 레코드에 대해 전화를 걸 수 있다면 각 Zap에 레코드 ID 앞의 고정 접두사를 각각 지정하세요. 발신 통화 걸기에서는 이 작업의 기반이 되는 API를 설명합니다.

Zap 예시#

• 통화 완료를 CRM으로 전송합니다. 완료된 각 통화의 상태, 종료 사유 및 녹취록을 활동으로 기록합니다.
• 통화 평가 결과를 후속 조치로 전송합니다. 통화 결과 또는 점수를 기준으로 필터링하고 통화를 적절한 후속 조치 워크플로로 라우팅합니다.
• 새 리드를 캠페인에 추가합니다. Add Contacts to Campaign을 사용하여 리드를 초안 캠페인에 추가한 다음, 누군가 목록을 승인하면 Start Campaign을 실행합니다.

통화 녹취록, 요약 및 녹음에는 개인 정보 또는 건강 정보가 포함될 수 있습니다. 해당 데이터를 사용하도록 조직에 허용된 앱에만 전송하고, 건강 정보가 관련된 경우 BAA에 따라 처리하며, 필요한 필드만 보관합니다.

문제 해결#

단계가 권한 부여 오류로 실패합니다. Zapier에서 ThunderPhone 연결을 다시 연결하고 다시 승인합니다. 연결한 사람이 ThunderPhone의 조직 → 키 → 승인된 앱에서 연결을 해제하거나, 해당 사람이 조직을 떠나거나, 30일 동안 토큰 새로 고침이 성공하지 않으면 연결이 작동하지 않습니다. OAuth로 연결을 참조하세요.

Zap을 켜거나 끄는 데 실패하거나 작업이 거부됩니다. 연결한 사람에게는 조직의 관리자 또는 소유자 역할이 필요합니다. 해당 역할이 있는 계정으로 다시 연결합니다. 이미 켜져 있는 트리거 Zap은 역할이 변경되거나 연결이 해제된 후에도 계속 통화 이벤트를 수신합니다. 이를 중지하려면 Zap을 끕니다.

앱 연결을 해제하려고 합니다. Zap을 끄면 엔드포인트가 삭제되고 정상적인 연결이 필요하므로, 연결을 해제하기 전에 ThunderPhone Zap을 끕니다. 먼저 연결을 해제했다면 관리자 API 키를 사용하여 DELETE /v1/developer/webhook-endpoints/{id}로 남아 있는 Zapier: … 엔드포인트를 삭제합니다. 웹훅 엔드포인트를 참조하세요.

Zap에서 다른 조직을 사용해야 합니다. 각 연결은 하나의 조직에 적용됩니다. 먼저 Zap을 꺼서 현재 조직에서 웹훅 엔드포인트를 삭제합니다. 그런 다음 Zapier에서 새 ThunderPhone 계정을 연결하고, 승인할 때 다른 조직을 선택한 후 각 ThunderPhone 단계에서 해당 연결을 선택합니다. 에이전트, 번호 및 캠페인은 조직마다 다르므로, 해당 항목이 있는 각 단계에서 에이전트, 발신 번호 및 캠페인을 다시 선택합니다. 그런 다음 Zap을 다시 켭니다.

트리거 실행이 중지되었습니다. ThunderPhone 트리거가 있는 각 Zap은 조직에서 Zapier: 통화 완료 또는 Zapier: 통화 평가됨이라는 하나의 웹훅 엔드포인트를 소유합니다. Zap을 켜면 생성되고 끄면 삭제됩니다. 그대로 둡니다. ThunderPhone에서 수정하거나 삭제했다면 Zap을 껐다가 다시 켜서 새 엔드포인트를 생성합니다. 관리자 API 키를 사용하면 GET /v1/developer/webhook-deliveries에서 최근 전송 시도를 확인할 수 있습니다.