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
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.
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.
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!
{{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.