콘텐츠로 이동

Counterbat API: Viber Bot 청구 세션

청구 카운터 기능

Counterbat API를 사용하면 세션 데이터를 실시간으로 모니터링하고 Cascade API를 활용하여 서비스 세션이나 이미 유료인 Viber Bot 세션에 추가 메시지를 보낼 수 있습니다.

청구 카운터 서비스 연결 방법

  1. 계약서에 서명하세요.
  2. 기능에 액세스하세요.
  3. 웹훅을 설정합니다.
  4. Cascade API의 패널과 기능을 사용하세요.

Viber REST API(Counterbat 에디션)

다음은 전체 Viber REST API 참조입니다. Counterbat 기능과 함께 사용하기 위해 https://chatapi.viber.com 엔드포인트가 https://api.counterbat.com/으로 대체되었습니다.

시작하기

API를 구현하려면 다음이 필요합니다. 1. 봇을 지원하는 플랫폼(iOS/Android)의 활성 Viber 계정. 2. 활성 봇. 3. 계정 인증 토큰. 4. 계정 웹훅을 설정합니다.

인증 토큰

각 API 요청에는 계정의 인증 토큰이 포함된 'X-Viber-Auth-Token'이라는 HTTP 헤더가 포함되어야 합니다.

X-Viber-Auth-Token: 445da6az1s345z78-dazcczb2542zv51a-e0vc5fva17480im9

웹훅

웹훅 설정

리소스 URL

https://api.counterbat.com/pa/set_webhook

게시물 데이터

{
   "url": "https://my.host.com",
   "event_types": [
      "delivered",
      "seen",
      "failed",
      "subscribed",
      "unsubscribed",
      "conversation_started"
   ],
   "send_name": true,
   "send_photo": true
}

웹훅 제거

웹훅을 비활성화하려면 빈 URL 문자열과 함께 set_webhook 요청을 게시하세요.

{
   "url": ""
}

메시지 보내기

send_message API를 사용하면 계정이 해당 계정을 구독하는 Viber 사용자에게 메시지를 보낼 수 있습니다.

리소스 URL

https://api.counterbat.com/pa/send_message

응답 예시

{
   "status": 0,
   "status_message": "ok",
   "message_token": 5741311803571721087,
   "chat_hostname": "SN-CHAT-05_",
   "billing_status": 1
}

키보드

API를 사용하면 send_message API를 사용하여 사용자 정의 키보드를 전송하여 사용자에게 사전 정의된 응답 또는 작업 세트를 제공할 수 있습니다.

리소스 URL

https://api.counterbat.com/pa/send_message

방송 메시지

'broadcast_message' API를 사용하면 계정이 해당 계정을 구독하는 여러 Viber 사용자에게 메시지를 보낼 수 있습니다. 최대 목록 길이는 수신기 300개입니다.

리소스 URL

https://api.counterbat.com/pa/broadcast_message

계정 정보 얻기

get_account_info 요청은 등록된 계정 세부정보를 가져옵니다.

리소스 URL

https://api.counterbat.com/pa/get_account_info

사용자 세부정보 가져오기

get_user_details 요청은 고유한 사용자 ID를 기반으로 특정 Viber 사용자의 세부 정보를 가져옵니다.

리소스 URL

https://api.counterbat.com/pa/get_user_details

온라인에 접속하세요

get_online 요청은 특정 가입 계정 회원의 온라인 상태를 가져옵니다(요청당 최대 100개의 사용자 ID).

리소스 URL

https://api.counterbat.com/pa/get_online

콜백

Viber는 subscribed, unsubscribed, conversation_started, delivered, seen, failedmessage와 같은 이벤트에 대한 콜백을 제공합니다. 콜백은 set_webhook 호출 중에 제공된 URL에 게시됩니다.