메시지 전송(Button Template)

    메시지 Bot이 버튼 템플릿을 전송할 수 있다.

    템플릿의 버튼을 이용하여 메시지에 postback 파라미터를 추가시켜 callback으로 서버에서 수신할 수 있다. 메시지 형식은 메시지 수신 - Callback 형태를 참고한다.

    메시지는 다국어로 전송할 수 있다. 다국어 메시지는 클라이언트의 단말기 언어 설정에 맞게 표시된다.

    버튼 템플릿의 구조는 다음과 같다.

    참고

    • 버튼 템플릿의 버튼은 최대 10개까지 등록할 수 있다.

    API 종류

    서버 API

    Request URL

    https://apis.worksmobile.com/r/{API ID}/message/v1/bot/{botNo}/message/push

    HTTP Method

    POST(Content-Type: application/json; charset=UTF-8)

    Request Content

    파라미터 타입 필수 여부 설명
    type string Y "button_template"으로 고정
    contentText string Y 본문 내용
    i18nContentTexts[] array N 다국어 본문 내용 목록
    i18nContentTexts[].language string Y 다국어 언어 코드
    ○ ko_KR ○ ja_JP ○ zh_CN ○ zh_TW ○ en_US
    i18nContentTexts[].contentText string Y 다국어 본문 내용
    최대 글자수: 1000자
    actions array<Action Object> Y 버튼 템플릿에 사용할 버튼

    Request Example

    
    {
      "accountId": "admin@example.com",    
      "content": {
        "type": "button_template",
        "contentText": "What do you want?",
        "actions": [{
          "type": "uri",
          "label": "WorksMobile Homepage",
          "uri": "https://line.worksmobile.com"
        }, {
          "type": "message",
          "label": "FAQ",
          "postback": "ButtonTemplate_FAQ"
        }]
      }
    }
    

    Response

    호출에 성공하면 HTTP 상태 코드 200을 반환하며, 응답은 반환하지 않는다.

    Error Code

    호출에 실패하면 오류 코드와 오류 메시지를 반환한다.
    오류 코드는 메시지 Bot REST API 오류 코드를 참고한다.