언급

Instagram 비즈니스 또는 크리에이터 계정의 별칭이 태그되거나 @언급된 캡션, 댓글, IG 미디어를 식별할 수 있습니다.

제한 사항

• 스토리의 언급은 지원되지 않습니다.
• 자신이 태그된 사진의 댓글은 지원되지 않습니다.
• 댓글 또는 @언급이 표시된 미디어가 비공개로 설정된 계정에서 생성되었을 경우 Webhooks가 전송되지 않습니다.

엔드포인트

API는 다음과 같은 엔드포인트로 구성됩니다.

• GET /{ig-user-id}/tags — 비즈니스 또는 크리에이터 계정이 태그된 미디어 개체 가져오기
• GET /{ig-user-id}?fields=mentioned_comment — 비즈니스 또는 크리에이터 계정이 @언급된 댓글에 대한 데이터 가져오기
• GET /{ig-user-id}?fields=mentioned_media — 비즈니스 또는 크리에이터 계정이 캡션에 @언급된 미디어 개체에 대한 데이터 가져오기
• POST /{ig-user-id}/mentions — 다른 Instagram 사용자가 비즈니스 또는 크리에이터 계정을 @언급한 댓글이나 미디어 개체 캡션에 답글 달기

사용 지침은 각 엔드포인트의 참고 자료 문서를 참조하세요.

Webhook

Instagram 사용자가 Instagram 비즈니스 또는 크리에이터 계정을 언급할 때마다 Instagram Webhooks 알림을 수신하도록 mentions 필드를 받아봅니다. Webhooks 알림 데이터는 저장되지 않으므로 언급을 수신하는 Webhook를 설정할 경우 나중에 사용할 계획이라면 수신한 데이터를 저장해야 합니다.

예시

댓글 @언급 수신 및 이에 답글 달기

댓글 @언급을 수신하고 기준에 맞는 항목에 답글을 달 수 있습니다.

1. mentions 필드에서 받아보는 Instagram Webhook를 설정합니다.
2. Webhooks 알림의 구문을 분석하고 댓글 ID를 식별할 수 있는 스크립트를 설정합니다.
3. ID를 사용하여 GET /{ig-user-id}/mentioned_comment 엔드포인트를 쿼리하고 각 댓글에 대한 자세한 정보를 가져옵니다.
4. 반환된 결과를 분석하여 기준에 맞는 댓글을 식별합니다.
5. POST /{ig-user-id}/mentions 엔드포인트를 사용하여 해당 댓글에 답글을 답니다.

이 답글은 비즈니스 또는 크리에이터 계정이 언급된 댓글에 대한 하위 대화창 댓글로 표시됩니다.

캡션 @언급 수신 및 이에 답글 달기

캡션 @언급을 수신하고 기준에 맞는 항목에 답글을 달 수 있습니다.

1. mentions 필드에서 받아보는 Instagram Webhook를 설정합니다.
2. Webhooks 알림의 구문을 분석하고 미디어 ID를 식별할 수 있는 스크립트를 설정합니다.
3. ID를 사용하여 GET /{ig-user-id}/mentioned_media 엔드포인트를 쿼리하고 각 미디어 개체에 대한 자세한 정보를 가져옵니다.
4. 반환된 결과를 분석하여 기준에 맞는 캡션이 포함된 미디어 개체를 식별합니다.
5. POST /{ig-user-id}/mentions 엔드포인트를 사용하여 해당 미디어 개체에 댓글을 남깁니다.