운영자 인증 및 딥링크

이 가이드에서는 API를 통해 시스템 운영자를 위한 유효한 인증 토큰을 얻는 방법과 딥 링크를 사용하여 채팅 패널로 이동하는 방법을 설명합니다.

API 기본 URL: https://chatapi.smsbat.com/ 스웨거: https://chatapi.smsbat.com/index.html

참고: 회사 수준 요청의 경우 'Bearer' 인증 대신 토큰과 함께 'X-Authorization-Key' 헤더(대시보드의 프로필에서 사용 가능)를 사용할 수 있습니다.

1. 회사 토큰 획득

회사 토큰을 얻으려면 회사의 로그인 자격 증명이 포함된 /api/company/get-token에 HTTP POST 요청을 보냅니다.

요청 - 방법: POST - URL: https://chatapi.smsbat.com/api/company/get-token - 헤더: 콘텐츠 유형: 애플리케이션/json

본문:

{
  "login": "string",
  "password": "string"
}

응답 - 상태 코드: 200(정상) - 본문: 문자열 토큰("your_token_string")

참고: 후속 요청을 위해 수신된 토큰을 저장하세요.

조직을 나열하려면 회사 토큰을 사용하여 /api/company/organization에 GET 요청을 보냅니다.

요청 - 방법: GET - URL: https://chatapi.smsbat.com/api/company/organization - 헤더: - 권한 부여: 전달자 {토큰} - 수락: 텍스트/일반

응답 - 상태 코드: 200(정상) - 본문:

[
  {
    "id": 6,
    "name": "string"
  }
]

organizationId 매개변수를 사용하여 /api/operator에 GET 요청을 보냅니다.

요청 - 방법: GET - URL: https://chatapi.smsbat.com/api/operator?organizationId={id} - 헤더: - 권한 부여: 전달자 {토큰} - 수락: 텍스트/일반

응답 - 상태 코드: 200(정상) - 본문:

[
  {
    "id": 21,
    "name": "string",
    "status": 1,
    "organization": {
      "id": 24,
      "name": "test_costs"
    }
  }
]

회사 토큰을 사용하여 이 엔드포인트에 액세스하고 운영자를 시스템에 동기화하십시오.

요청 - 방법: POST - URL: https://chatapi.smsbat.com/api/operator/synchronize - 헤더: - 권한 부여: 전달자 {토큰} - 콘텐츠 유형: 애플리케이션/json

본문:

[
  {
    "organizationId": 24,
    "name": "string"
  }
]

응답 - 상태 코드: 200(정상) - 본문:

[
  {
    "id": 21,
    "status": 0,
    "name": "string"
  }
]

가능한 운영자 상태: - 활성: 0 - 비활성: 1 - 삭제됨: 2

특정 운영자에 대한 토큰을 얻으려면 회사 토큰으로 승인하세요.

요청 - 방법: POST - URL: https://chatapi.smsbat.com/api/operator/get-token - 헤더: - 권한 부여: 전달자 {토큰} - 콘텐츠 유형: 애플리케이션/json

본문:

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}

expiresAt는 필수이며 운영자의 세션 기간(최대 +24시간)을 결정합니다.

응답 - 상태 코드: 200(정상) - 본문: 문자열 토큰

운영자 토큰의 유효성을 확인합니다.

요청 - 방법: POST - URL: https://chatapi.smsbat.com/api/operator/validate-token - 헤더: - 권한 부여: 전달자 {토큰} - 콘텐츠 유형: 애플리케이션/json

본문: "operator_token_string"

유효한 응답(200 OK):

{
  "isValid": true,
  "operatorId": 0,
  "clientId": 0,
  "expiresAt": "2024-12-28T14:04:15.861Z",
  "error": null
}

외부 시스템(CRM, ERP, 내부 웹사이트)은 JWT 운영자 토큰을 매개변수로 전달하여 딥링크를 활용하여 채팅 패널을 직접 열 수 있습니다. 토큰이 유효하지 않거나 만료된 경우 사용자는 로그인 인터페이스로 리디렉션됩니다.

https://chat.smsbat.com/?chat_raw_id=<chat_id>&token=<jwt_token>

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>

전화번호는 E.164 국제 형식이어야 합니다.

https://chat.smsbat.com/?from=<bm_id>&phone=<phone_number>&token=<jwt_token>

메시지를 가로챌 소스를 정확하게 지정하세요.

https://chat.smsbat.com/?source=<sourceId>&from=<bm_id>&phone=<phone_number>&token=<jwt_token>

채팅 소스: - 0 - 바이버 - 1 - ViberBot - 2 - 텔레그램봇 - 3 - Whatsapp - 4 - 위젯 - 5 - 로제트카 - 6 - 페이스북 - 7 - 인스타그램