Connected Content FAQ
Frequently asked questions about configuring Connected Content and handling its responses.
These are the questions we hear most often when setting up and using Connected Content.
Can I use connected_content multiple times in one message?
Yes. However, all connected_content calls in one message share a cumulative time budget of 2 seconds. If the first call took 1.8 seconds, the second call must finish within 0.2 seconds. Once the limit is exceeded, subsequent calls are immediately skipped without a network call. Use multiple calls only when the average response time of the external API is sufficiently short.
Won't it take a long time to send while waiting for the response?
Each call terminates within a maximum of 2 seconds. The cumulative limit for one message is also 2 seconds. Send delays do not accumulate indefinitely.
How do I access the response when it is a JSON array?
If the top level is an array, it is not recognized as an object and becomes an empty value. Have the API return a response wrapped in an object, such as {"items":[...]}. You can also set up a separate wrapping endpoint.
Can I use non-JSON responses (e.g., plain text, HTML)?
Not supported. If it cannot be parsed as a JSON object, it is treated as an empty value.
I want to use the response only for conditional branching without displaying it directly in the message.
You can use the :save variable directly in {% if %} and the like. You do not need to output it in the message body. Refer to the examples in Behavior on Failure.
How do I extract a response field whose key contains Korean characters, spaces, or dots?
Use bracket subscript in the form {{var["key name"]}}. Single quotes (') can also be used.
Last updated