아이스 브레이커

아이스 브레이커는 사용자가 자주 묻는 질문 리스트로 비즈니스와 대화를 시작할 수 있는 수단을 제공합니다. 아이스 브레이커 API를 통해 최대 4가지 질문을 설정할 수 있습니다.

2021년 10월 19일부터 아이스 브레이커는 비즈니스가 사용자 로캘에 따라 맞춤 질문을 설정할 수 있도록 현지화를 지원합니다. 이 API는 새로운 형식을 사용하게 됩니다. 개발자께서는 새로운 형식을 활용하여 아이스 브레이커 정보를 설정하고 검색하시기 바랍니다. 지원되는 로캘 리스트는 여기에서 확인할 수 있습니다.

아이스 브레이커 설정

새로운 형식(권장)

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

기존 형식(새로운 아이스 브레이커 설정에 사용하지 말 것)

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

아이스 브레이커 가져오기

아이스 브레이커를 설정하는 방식에 따라 GET 요청이 다른 형식을 반환합니다. 다음의 동작이 적용됩니다.

• 기존 형식을 사용하여 아이스 브레이커를 설정할 경우 GET 요청이 기존 형식의 응답을 반환합니다.
• 새로운 형식을 사용하여 아이스 브레이커를 설정할 경우 GET 요청이 새로운 형식의 응답을 반환합니다.

향후 기존 형식은 사용 중단될 예정이므로 개발자분께서는 새 형식으로 마이그레이션하는 것이 좋습니다.

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

새로운 형식 응답

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

기존 형식 응답

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

아이스 브레이커 삭제

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Webhooks 이벤트

아이스 브레이커에서 포스트백 Webhooks를 수신하려면 앱이 앱 설정의 Instagram 주제에서 messaging_postbacks v8.0+ Webhooks를 구독해야 합니다.

이 Webhooks는 아래의 예시와 유사한 JSON 페이로드를 수신합니다.

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}