> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tedro.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram Nodes

> Send direct messages and escalate conversations on Instagram.

# Instagram Nodes

Instagram nodes handle communication with contacts through Instagram DMs. Use them to send automated replies and escalate conversations to human agents. These nodes work exclusively with the **Instagram** channel.

<Note>
  Instagram DMs have a **1,000 character limit** and do not support buttons, list menus, or rich text formatting. Messages support text and media (images, video, audio) only.
</Note>

***

## ig.send\_message

**Send a direct message on Instagram.**

This node sends a text message back through Instagram DMs. It supports dynamic variables from the workflow context for personalized responses.

### Configuration

| Option | Type   | Required | Description                                                                        |
| ------ | ------ | -------- | ---------------------------------------------------------------------------------- |
| `body` | string | Yes      | Message text. Supports context variables like `{{contact.name}}` and custom fields |

### Variable Substitution

Use double curly braces to inject dynamic values:

```
Hi {{contact.name}}, thanks for reaching out on Instagram!
```

Available variables include:

* `{{contact.name}}` -- The contact's name
* `{{contact.fields.*}}` -- Any custom fields set on the contact
* `{{conversation.fields.*}}` -- Any custom fields set on the conversation

### Outputs

| Output      | Type   | Description                                             |
| ----------- | ------ | ------------------------------------------------------- |
| `messageId` | string | The Instagram message ID                                |
| `status`    | string | Delivery status (`sent`, `delivered`, `read`, `failed`) |

### Connections

* **Inputs**: Single input handle from the previous node
* **Outputs**: Single output handle for chaining additional actions

### Example Use Case

After an AI Agent generates a response to an Instagram DM, connect it to an Instagram Send Message node to deliver the reply. Keep responses concise due to the 1,000 character limit.

***

## ig.handoff

**Escalate the Instagram conversation to a human agent.**

The Handoff node moves the Instagram conversation from automated processing to the human agent inbox. The conversation appears in the **Inbox** with a "handoff" status and an **Instagram** channel indicator (pink).

### Configuration

| Option   | Type   | Required | Description                                                                        |
| -------- | ------ | -------- | ---------------------------------------------------------------------------------- |
| `reason` | string | No       | Optional note explaining why the handoff occurred (visible to agents in the inbox) |

### Outputs

| Output           | Type   | Description                                               |
| ---------------- | ------ | --------------------------------------------------------- |
| `handoff.status` | string | Always `handoff` -- the conversation is now in agent mode |

### Connections

* **Inputs**: Single input handle from the previous node
* **Outputs**: Single output handle (typically connected to a `logic.end` node or left unconnected)

### Example Use Case

When an Instagram DM conversation requires human attention -- for example, a product return request or a complex inquiry -- route to the Instagram Handoff node. The agent sees the conversation in their Inbox with the Instagram channel indicator.