알림 그룹

알림 그룹을 사용하면 같은 주제의 알림들이 기기 알림창에서 하나의 그룹으로 묶여 표시됩니다. 알림이 여러 개 쌓여도 알림창이 지저분해지지 않고, 사용자는 그룹을 펼쳐 개별 알림을 확인할 수 있습니다.

_{이미지 출처: Android Developers 공식 문서}

지원 버전

항목	요구 사항
iOS	모든 SDK 버전 (OS 가 직접 처리, iOS 12 이상)
Android	FlareLane SDK 1.11.0 이상 / Android 7.0 이상

각 플랫폼의 공식 문서도 함께 참고하세요: Apple - threadIdentifier · Android - Create a group of notifications

발송 방법

Open API 알림 발송 시 threadId 를 지정합니다. 같은 값을 가진 알림들이 하나의 그룹으로 묶입니다.

curl -X POST "https://api.flarelane.com/v1/projects/{PROJECT_ID}/notifications" \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "targetType": "all",
    "title": "주문 알림",
    "body": "주문하신 상품이 배송을 시작했어요",
    "threadId": "order_status"
  }'

필드	필수	설명
`threadId`	선택	알림 그룹 키 (최대 64자). 같은 값의 알림끼리 묶입니다. Liquid 변수 사용 가능

플랫폼별 표시 방식

iOS: 같은 threadId의 알림들이 알림 센터에서 하나의 스레드로 겹쳐 쌓입니다. 개별 알림은 유지됩니다
Android: 같은 threadId의 알림이 2개 이상 쌓이면 하나의 그룹 카드로 접혀 개수가 표시되고, 펼치면 개별 알림을 각각 확인할 수 있습니다

채팅 스타일 알림과 함께 사용하면 같은 발신자의 메시지가 대화처럼 이어져 보입니다.