고객 서비스 메시지


고객 서비스 메시지

사용자가 특정 작업으로 공식 계정과 상호작용하면(구체적인 작업 목록은 아래 설명 참조) WeChat에서 메시지 데이터를 푸시합니다. 개발자는 일정 시간(현재 48시간으로 수정) 내에 고객 서비스 인터페이스를 호출하고 JSON 데이터 패킷을 POST하여 일반 사용자에게 메시지를 보낼 수 있습니다. 이 인터페이스는 개발자가 사용자에게 더 나은 서비스를 제공할 수 있도록 수동 메시지 처리가 필요한 고객 서비스 등의 기능에 주로 사용됩니다.

현재 허용되는 작업 목록은 다음과 같습니다. (공용 플랫폼은 운영 상황에 따라 목록을 업데이트합니다. 다양한 작업이 트리거된 후 고객 서비스 인터페이스에서 보낼 수 있는 메시지 수 메시지 수가 상한에 도달한 후에는 오류 반환 코드가 발생하는 경우 자세한 내용은 반환 코드 설명 페이지를 참조하세요.): 

1、用户发送信息
2、点击自定义菜单（仅有点击推事件、扫码推事件、扫码推事件且弹出“消息接收中”提示框这3种菜单类型是会触发客服接口的）
3、关注公众号
4、扫描二维码
5、支付成功
6、用户维权

공식 계정 사용을 돕기 위해 다양한 고객 서비스 ID를 사용하여 다양한 사용자 그룹에 서비스를 제공하고 고객 서비스 인터페이스가 업그레이드되었으며 개발자는 고객 서비스 계정을 관리하고 고객 서비스 계정의 아바타와 닉네임을 설정할 수 있습니다. 이 기능은 고객 서비스 인터페이스 권한이 있는 모든 공개 계정에 열려 있습니다.

또한 개발자는 이 인터페이스에서 media_id가 사용되는 모든 위치에서 이제 자재 관리에서 영구 자재 media_id를 사용할 수 있다는 점에 유의하시기 바랍니다.


고객 서비스 계정 관리

개발자가 개발 문서의 요구 사항에 따라 개발을 완료한 후 버전 6.0.2 이상을 사용하는 WeChat 사용자는 공식 계정과 통신합니다. 고객 서비스 공식 계정이 다른 고객 서비스 계정을 사용하여 응답한 후 사용자는 해당 고객 서비스 아바타와 닉네임을 볼 수 있습니다.

이 기능을 사용하려면 먼저 공개 플랫폼의 공식 웹사이트에서 공개 계정에 대한 WeChat ID를 설정해야 합니다.

고객 서비스 계정 추가

개발자는 이 인터페이스를 통해 공개 계정에 고객 서비스 계정을 추가할 수 있습니다. 공개 계정에는 최대 10개의 고객 서비스 계정을 추가할 수 있습니다. 인터페이스 호출 요청은 다음과 같습니다: 

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/add?access_token=ACCESS_TOKEN

POST 데이터 예는 다음과 같습니다: 

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

반환 설명(정확한 경우 JSON 반환 결과): 

{
     "errcode" : 0,
     "errmsg" : "ok",
}
# 🎜🎜#Error WeChat은 오류 코드에 따라 오류 정보를 반환합니다.

#🎜 🎜#

#🎜 🎜#

고객 서비스 계정 수정

개발자는 이 인터페이스를 통해 공용 계정에 대한 고객 서비스 계정을 수정할 수 있습니다. . 인터페이스 호출 요청은 다음과 같습니다: 

http请求方式: POST
https://api.weixin.qq.com/customservice/kfaccount/update?access_token=ACCESS_TOKEN

POST 데이터 예는 다음과 같습니다: 

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

반환 설명(정확한 경우 JSON 반환 결과): 

{
     "errcode" : 0,
     "errmsg" : "ok",
}
# 🎜🎜#Error WeChat은 오류 코드에 따라 오류 정보를 반환합니다.

#🎜 🎜#

#🎜 🎜#

고객 서비스 계정 삭제

개발자는 이 인터페이스를 통해 공개 계정에 대한 고객 서비스 계정을 삭제할 수 있습니다. 인터페이스 호출 요청은 다음과 같습니다: 

http请求方式: GET
https://api.weixin.qq.com/customservice/kfaccount/del?access_token=ACCESS_TOKEN

POST 데이터 예는 다음과 같습니다: 

{
     "kf_account" : "test1@test",
     "nickname" : "客服1",
     "password" : "pswmd5",
}

반환 설명(정확한 경우 JSON 반환 결과): 

{
     "errcode" : 0,
     "errmsg" : "ok",
}
# 🎜🎜#Error WeChat은 오류 코드에 따라 오류 정보를 반환합니다.

#🎜 🎜#

#🎜 🎜#

고객 서비스 계정의 아바타 설정

개발자는 이 인터페이스를 호출하여 고객으로 사진을 업로드할 수 있습니다. 서비스 담당자 아바타 및 아바타 이미지 파일은 jpg 형식이어야 하며, 최상의 효과를 얻으려면 640*640 크기의 이미지를 사용하는 것이 좋습니다. 인터페이스 호출 요청은 다음과 같습니다: 

http请求方式: POST/FORM
http://api.weixin.qq.com/customservice/kfaccount/uploadheadimg?access_token=ACCESS_TOKEN&kf_account=KFACCOUNT
调用示例：使用curl命令，用FORM表单方式上传一个多媒体文件，curl命令的具体用法请自行了解

반환 지침(정확한 경우 JSON 반환 결과): 

{
     "errcode" : 0,
     "errmsg" : "ok",
}

오류가 발생하는 경우 WeChat은 오류 코드 및 기타 정보를 반환합니다. 에러코드에 따라 문의해 주세요. 에러 메시지

모든 고객 서비스 계정 가져오기

개발자는 이 인터페이스를 사용하여 공식 계정 고객 서비스 ID, 고객 서비스 닉네임, 고객 서비스 로그인 계정을 포함한 기본 정보입니다. 

http请求方式: GET
https://api.weixin.qq.com/cgi-bin/customservice/getkflist?access_token=ACCESS_TOKEN

반환 지침(정확한 경우 JSON 반환 결과): 

{
    "kf_list": [
        {
            "kf_account": "test1@test", 
            "kf_nick": "ntest1", 
            "kf_id": "1001"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw/0"
        }, 
        {
            "kf_account": "test2@test", 
            "kf_nick": "ntest2", 
            "kf_id": "1002"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }, 
        {
            "kf_account": "test3@test", 
            "kf_nick": "ntest3", 
            "kf_id": "1003"
            "kf_headimgurl": " http://mmbiz.qpic.cn/mmbiz/4whpV1VZl2iccsvYbHvnphkyGtnvjfUS8Ym0GSaLic0FD3vN0V8PILcibEGb2fPfEOmw /0"
        }
    ]
}

오류가 발생한 경우 WeChat은 오류 코드 및 기타 정보를 반환합니다. 다음에 따라 오류 정보를 쿼리하세요. 오류 코드

인터페이스의 균일한 매개변수 설명

# 🎜 🎜#access_token은 통화 인터페이스 자격 증명kf_account#🎜입니다. 🎜# # 🎜 🎜#은 전체 고객 서비스 계정이며 형식은 다음과 같습니다. 계정 접두어@공개 계정 WeChat IDkf_nick고객센터 닉네임kf_id은입니다 고객센터 전화번호#🎜 🎜# 고객센터 닉네임은 # 🎜🎜#passwordNo 고객 서비스 계정 로그인 비밀번호, 형식은 32비트 암호화된 MD5 값입니다. 비밀번호 일반 텍스트.이 비밀번호는 공공 플랫폼 공식 홈페이지의 다중 고객 서비스 기능에서만 사용됩니다. 다중 고객 서비스 기능을 사용하지 않는 경우에는 비밀번호를 설정할 필요가 없습니다
Parameter필수인가요설명
nickname
이며, 최대 한자 6자 또는 영문 12자까지 가능합니다.
media예 이 매개변수는 고객 서비스 아바타를 설정할 때만 나타납니다. 데이터의 미디어 파일 식별에는 파일 이름, 파일 길이, 콘텐츠 유형 및 기타 정보가 포함됩니다

고객 서비스 인터페이스 - 메시지 보내기

인터페이스 통화 요청 설명

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

각 메시지 유형에 필요한 JSON 데이터 패킷은 다음과 같습니다.

문자 메시지 보내기 

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    }
}

사진 메시지 보내기

{
    "touser":"OPENID",
    "msgtype":"image",
    "image":
    {
      "media_id":"MEDIA_ID"
    }
}

음성 메시지 보내기

{
    "touser":"OPENID",
    "msgtype":"voice",
    "voice":
    {
      "media_id":"MEDIA_ID"
    }
}

영상 메시지 보내기

{
    "touser":"OPENID",
    "msgtype":"video",
    "video":
    {
      "media_id":"MEDIA_ID",
      "thumb_media_id":"MEDIA_ID",
      "title":"TITLE",
      "description":"DESCRIPTION"
    }
}

음악 메시지 보내기

{
    "touser":"OPENID",
    "msgtype":"music",
    "music":
    {
      "title":"MUSIC_TITLE",
      "description":"MUSIC_DESCRIPTION",
      "musicurl":"MUSIC_URL",
      "hqmusicurl":"HQ_MUSIC_URL",
      "thumb_media_id":"THUMB_MEDIA_ID" 
    }
}

그래픽 메시지 보내기(외부 링크로 이동하려면 클릭) 그래픽 메시지 수는 8개로 제한됩니다. 그래픽 메시지 수가 8개를 초과하는 경우, 그러면 응답이 없을 것입니다. 

{
    "touser":"OPENID",
    "msgtype":"news",
    "news":{
        "articles": [
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         },
         {
             "title":"Happy Day",
             "description":"Is Really A Happy Day",
             "url":"URL",
             "picurl":"PIC_URL"
         }
         ]
    }
}

그래픽 메시지 보내기(그래픽 메시지 페이지로 이동하려면 클릭). 그래픽 메시지 수는 8개로 제한됩니다. 그래픽 메시지 수가 8개를 초과하면 응답이 없습니다. 

{
    "touser":"OPENID",
    "msgtype":"mpnews",
    "mpnews":
    {
         "media_id":"MEDIA_ID"
    }
}

카드 및 쿠폰 보내기

{
  "touser":"OPENID", 
  "msgtype":"wxcard",
  "wxcard":{              
           "card_id":"123dsdajkasd231jhksad"        
            },
}

특히 고객 서비스 메시지 인터페이스는 맞춤 코드가 아닌 카드와 가져온 코드 모드 카드만 지원한다는 점에 유의하세요.

고객 서비스 계정으로 메시지를 보내야 하는 경우(WeChat 6.0.2 이상에서 사용자 정의 아바타를 표시하기 위해) JSON 데이터 패킷 사용자 정의 서비스 매개변수를 추가합니다. 예를 들어 문자 메시지를 보낼 때 다음과 같이 변경합니다. 

{
    "touser":"OPENID",
    "msgtype":"text",
    "text":
    {
         "content":"Hello World"
    },
    "customservice":
    {
         "kf_account": "test1@kftest"
    }
}
# 🎜🎜#access_token은 인터페이스 자격 증명 호출 touser is Normal user openidmsgtype is 메시지 유형, 텍스트는 텍스트, 사진은 이미지, 음성은 음성, 영상 메시지는 영상, 음악 메시지는 음악, 그래픽 메시지(클릭하면 외부 링크로 이동), 그래픽 메시지(클릭하면 외부 링크로 이동) 그래픽 메시지 페이지)는 mpnews, 카드 쿠폰은 wxcardcontent은 문자 메시지 내용# 🎜🎜#media_id은 전송된 사진/음성/동영상/그래픽 메시지의 미디어 ID#입니다(그래픽 메시지 페이지로 이동하려면 클릭하세요). 작성자: 🎜🎜#
Parameter필수인가요설명
# 🎜🎜#
thumb_media_id는 thumbnail
titleNo그래픽 메시지/동영상 메시지/음악 메시지 제목
descriptionNo의 미디어 ID입니다. 그래픽 메시지/비디오 메시지/설명 음악 메시지
musicurl ismusic link
hqmusicurlis고품질 음악 링크, Wi-Fi 환경에서는 이 링크를 사용하여 음악을 재생하는 것이 우선입니다
urlno 그래픽 메시지 클릭 후 점프하는 링크
picurlNo 그래픽 메시지의 이미지 링크는 JPG, PNG 형식을 지원하며 가장 좋은 효과는 큰 이미지의 경우 640*320, 작은 이미지의 경우 80*80입니다. 이미지

인터페이스 반환 설명

반환 데이터 예(올바른 JSON 반환 결과):

1474854155959481.png#🎜🎜 ## 🎜🎜#


←
→