> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/crm-marketing/message-personalization/connected-content-faq.md).

# 커넥티드 콘텐츠 FAQ

커넥티드 콘텐츠를 설정하고 사용할 때 자주 묻는 질문입니다.

#### 한 메시지에 `connected_content`를 여러 번 써도 되나요?

가능합니다. 단, 한 메시지의 모든 `connected_content` 호출은 누적 2초의 시간 예산을 공유합니다. 첫 번째 호출이 1.8초 걸렸다면 두 번째 호출은 0.2초 안에 끝나야 합니다. 한도를 초과하면 이후 호출은 네트워크 호출 없이 즉시 스킵됩니다. 외부 API의 평균 응답시간이 충분히 짧을 때만 다중 호출을 사용하세요.

***

#### 응답을 받기 전에 발송 시간이 오래 걸리진 않나요?

각 호출은 최대 2초 안에 종료됩니다. 한 메시지의 누적 한도도 2초입니다. 발송 지연이 무한정 누적되지 않습니다.

***

#### 응답이 JSON 배열일 때는 어떻게 접근하나요?

최상위가 배열이면 객체로 인식되지 않아 빈 값이 됩니다. API가 `{"items":[...]}`처럼 객체로 감싼 응답을 반환하도록 하세요. 래핑 엔드포인트를 따로 둘 수도 있습니다.

***

#### JSON이 아닌 응답(예: 단순 텍스트, HTML)도 사용할 수 있나요?

지원하지 않습니다. JSON 객체로 파싱되지 않으면 빈 값으로 처리됩니다.

***

#### 응답을 메시지에 직접 노출하지 않고 조건 분기에만 쓰고 싶어요.

`:save` 변수를 `{% if %}` 등에서 그대로 사용할 수 있습니다. 메시지 본문에 출력할 필요는 없습니다. [실패 시 동작](/crm-marketing/message-personalization/connected-content.md#undefined-7)의 예시를 참고하세요.

***

#### 키에 한글, 공백, 점이 들어 있는 응답 필드는 어떻게 꺼내나요?

`{{var["키 이름"]}}` 형태의 bracket subscript를 사용하세요. 작은따옴표(`'`)도 사용할 수 있습니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hackle.io/crm-marketing/message-personalization/connected-content-faq.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.