# Retrieve Chat History

Retrieve the conversation's recent message history as a JSON array

## Plan availability

| Feature | Free | Starter | Pro | Enterprise |
| --- | --- | --- | --- | --- |
| Active workflows | 3 | 10 | 45 | Unlimited |

Allowances follow the [published Chatigram pricing page](https://chatigram.com/pricing/). Your organization’s Billing & Plans screen confirms its subscription and current usage. Plans can change. Plan information reviewed 2026-11-10.


## When to use this node

Retrieve the conversation's recent message history as a JSON array

Add **Retrieve Chat History** to a workflow branch using the node picker. Configure its fields in the inspector, then connect the next step.

> This node needs conversation context. Use it in a conversation workflow; a Manual or scheduled trigger does not create a customer conversation by itself.

## Configure the fields

| Field | What to enter |
| --- | --- |
| **Chatigram sender** | The sender value used for messages sent by Chatigram users and workflows |
| **External sender** | The sender value used for messages received by Chatigram |
| **Recent message limit** | The maximum number of recent messages to retrieve. Leave blank to use the default of 50. |

## Use the result

Choose the output from the variable picker in a later step. Output names below identify the values supplied by this node; the picker inserts the correct reference for your node instance.

| Output | Meaning / label |
| --- | --- |
| `messagesJson` | Messages JSON |

## Connect the next step

Connect the continuation shown on the canvas. Some nodes calculate their branches from the configured options. Read each branch label in the editor and connect the paths your workflow needs.

## Test it in a workflow

1. Configure this node with a small, recognizable test input or a test resource.
2. Check the variables from preceding steps and the connection selected in the inspector.
3. Save the workflow. For event-driven flows, generate the actual event; use **Run** only for a Manual workflow.
4. Open **Workflow Activity** and check the outcome before enabling wider use.

## If something goes wrong

- Check empty variables, selected resource IDs, and any fields that appeared after resource selection.
- Check the failed step in Workflow Activity before retrying. If the action may already have completed, inspect the destination first to avoid duplicates.
- Follow the [troubleshooting guide](/help/troubleshooting/) for a symptom-by-symptom checklist.

## Related guides

- [Work with variables](/workflows/variables/)
- [Understand branches and error handling](/workflows/branches/)
- [Browse all nodes](/reference/nodes/)
- [A/B Testing](/nodes/ab-testing/)
- [Analyze Image](/nodes/attachment-analyze-image/)
- [Ask Multiple Choice Question](/nodes/ask-multiple-choice-question/)
- [ChatGPT Task](/nodes/chatgpt-task/)
- [Check condition](/nodes/if-statement/)


## Catalog coverage

This is the currently documented selection. Chatigram continues to add nodes, triggers, App Connections, and integrations. Use each page’s review date and the current application selectors to check what is available now; this catalog is not a fixed limit on future features.