드롭다운 및 캐러셀 API
Freshchat의 대화 API를 사용하여 대화 워크플로우를 확장하고 대화에 드롭다운 및 캐러셀을 사용할 수 있습니다. 일반적인 답변 텍스트 상자 대신 드롭다운이나 캐러셀을 응답 유형으로 추가하여 고객 경험을 향상시킬 수 있습니다.
드롭다운이란 무엇인가요?
드롭다운은 고객이 선택할 수 있는 옵션 목록입니다.
예를 들어,
캐러셀이란 무엇인가요?
캐러셀은 고객이 선택할 수 있는 옵션의 수평 슬라이딩 카탈로그입니다. 각 옵션은 이미지, 제목, 설명 및 두 개의 버튼이 있는 카드로 표시됩니다.
예를 들어, 고객이 사이즈 12의 신발 목록을 요청하면 상담원은 여러 웹페이지 링크를 공유하는 대신 캐러셀 API를 사용하여 옵션 카탈로그를 보낼 수 있습니다. 고객은 여기서 선택을 할 수 있으며, 이는 고객에게 풍부한 경험을 제공하고 아이템을 선택하고 주문을 쉽게 할 수 있도록 합니다.
고객이 옵션을 선택하면 상담원이 결제 링크 또는 체크아웃 페이지를 해당 아이템과 함께 공유할 수 있습니다.
캐러셀의 요소
캐러셀은 네 가지 요소로 구성됩니다,
이미지 - 지원되는 이미지 형식은 JPEG, PNG 및 GIF이며 최대 파일 크기는 2MB입니다.
제목 및 설명 - 이미지의 제목과 해당 이미지의 설명입니다.
기본 버튼 - 고객이 선택할 수 있는 선택 버튼입니다.
보조 버튼 - URL을 하이퍼링크할 수 있는 선택적 버튼입니다.
참고: 캐러셀은 최대 두 개의 버튼을 가질 수 있습니다.
드롭다운 API 페이로드
curl--location--request POST
'https://<API_URL_GOES_HERE>/v2/conversations/<CONVERSATION_ALIAS_GO
ES_HERE > /messages' \
--header 'Authorization: Bearer <AUTH_TOKEN_GOES_HERE>'\
--header 'Content-Type: application/json'\
--data - raw '{
"actor_id": < AGENT_ALIAS_GOES_HERE > ,
"message_type": "normal",
"actor_type": "agent",
"message_parts": [
{
"text":
{
"content": "<b>Dropdown</b><br/> Agent MESSAGE - from postman"
}
}],
"reply_parts": [
{
"template_content":
{
"type": "quick_reply_dropdown",
"sections": [
{
"name": "options",
"parts": [
{
"quick_reply_button":
{
"label": "Google",
"custom_reply_text": "Google",
"payload": "123_Google"
}
},
{
"quick_reply_button":
{
"label": "Yahoo",
"custom_reply_text": "Yahoo",
"payload": "234_yahoo"
}
},
{
"quick_reply_button":
{
"label": "Reddit",
"custom_reply_text": "Reddit"
}
}]
}]
}
}]
}
'캐러셀 API 페이로드
curl--location--request POST
'https://<API_URL_GOES_HERE>/v2/conversations/<CONVERSATION_ALIAS_GO
ES_HERE > /messages' \
--header 'Authorization: Bearer <AUTH_TOKEN_HERE>
--data - raw '{
"actor_id": < AGENT_ID_GOES_HERE > ,
"message_type": "normal",
"actor_type": "agent",
"message_parts": [
{
"text":
{
"content": "<b>Carousel</b><br/> Agent MESSAGE - from postman"
}
}],
"reply_parts": [
{
"template_content":
{
"type": "carousel",
"sections": [
{
"name": "carousel_title",
"parts": [
{
"text":
{
"content": "Hello choose one of following..."
}
}]
},
{
"name": "cards",
"parts": [
{
"template_content":
{
"type": "carousel_card_default",
"sections": [
{
"name": "hero_image",
"parts": [
{
"image":
{
"url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x9
2 dp.png "
}
}]
},
{
"name": "title",
"parts": [
{
"text":
{
"content": "This is title"
}
}]
},
{
"name": "description",
"parts": [
{
"text":
{
"content": "This is description"
}
}]
},
{
"name": "callback",
"parts": [
{
"callback":
{
"payload": "thisispayload",
"label": "callback"
}
}]
},
{
"name": "view",
"parts": [
{
"url_button":
{
"url": "http://google.com",
"label": "google",
"target": "_blank"
}
}]
}]
}
},
{
"template_content":
{
"type": "carousel_card_default",
"sections": [
{
"name": "hero_image",
"parts": [
{
"image":
{
"url": "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x9
2 dp.png "
}
}]
},
{
"name": "title",
"parts": [
{
"text":
{
"content": "This is title"
}
}]
},
{
"name": "description",
"parts": [
{
"text":
{
"content": "This is description"
}
}]
},
{
"name": "callback",
"parts": [
{
"callback":
{
"payload": "thisispayload",
"label": "callback"
}
}]
},
{
"name": "view",
"parts": [
{
"url_button":
{
"url": "http://google.com",
"label": "google",
"target": "_blank"
}
}]
}]
}
}]
}]
}
}]
}
'드롭다운 및 캐러셀 (Android 및 iOS SDK)
iOS 또는 Android 모바일 앱에서도 드롭다운 및 캐러셀을 응답 유형으로 사용할 수 있습니다.
