Chatigram documentation

Build assistants, automate workflows, and connect channels with Chatigram.

1. Getting started

Chatigram lets you build AI-powered assistants that run on chat channels like Livechat, Telegram, WhatsApp, Instagram, and more. You design the logic visually, and Chatigram handles routing, AI calls, and messaging for you.

  • Create Lines for each channel (website widget, Telegram, etc.).
  • Design Workflows in a visual editor using nodes.
  • Use Ask AI nodes for intelligent responses.
  • Monitor and intervene from the Inbox.
Quick start: Create a Line (e.g. Livechat) → Create or duplicate a workflow → Attach it to the Line → Open the direct chat link to test the full flow.
Tip – You don’t need to be a developer to start. Most use cases can be built visually using nodes for messages, conditions, and integrations.
Where to use Chatigram: Your account is available at app.chatigram.com. This documentation will continue to evolve as we release new features like Chatigram Page and native mobile apps.

1.1 Sign up & sign in

You can sign up or sign in to Chatigram using:

  • SSO providers: Google, Microsoft, LinkedIn, Facebook.
  • Email: create an account or log in using your email address.

Chatigram supports installation as a Progressive Web App (PWA) in modern browsers, so you can “install” it and open it as if it were a native desktop app.

2. Core concepts

2.1 Lines

A Line is a communication channel where conversations happen. Examples:

Livechat (website widget) Telegram WhatsApp Instagram …etc.

2.2 Workflows

A Workflow is a visual automation made of connected nodes. It defines how Chatigram responds to:

  • New conversations and messages.
  • Changes in conversation status.
  • Incoming webhooks.
  • Scheduled time-based events (cron).

2.3 Nodes

Nodes are the steps in a workflow. Examples:

  • Send Text Message – reply to the user.
  • Receive Text Message – wait for user input.
  • Ask AI – send a prompt to a configured AI model.
  • External API integration – call HTTP APIs and extract data.
  • Check Condition – branch logic based on rules.
  • Set Variable – store values for later use.

2.4 Variables

Variables store data such as user replies, workflow properties, AI responses, and API results. You insert variables into node fields using the variables picker.

2.5 Inbox

The Inbox shows all active and historical conversations. You see both user messages and actions taken by workflows. You can always step in and reply manually.

3. Lines & channels

3.1 Viewing lines

Open the Lines page to see all configured channels. For each line you’ll see:

  • Name – e.g., “Default”, “Chatigram Website”.
  • Type – Livechat, Telegram, WhatsApp, Instagram, etc.
  • Status – connected or not.

3.2 Creating a new line

  1. Navigate to Lines.
  2. Click Create new.
  3. Select the channel type (e.g. Livechat or Telegram).

Then configure:

  • Line name – an internal label.
  • Allowed workflows:
    • All – any enabled workflow can run on this line.
    • Some – choose specific workflows to handle chats.
    • None – no workflows; only manual handling.
  • Appearance (Livechat) – chat title, subtitle, logo, brand color.
  • Embedding (Livechat) – website URL, tooltip text, and script snippet.

3.3 Direct chat links

Each Livechat line provides a Start a new chat link. Use this link to:

  • Test the workflow quickly in your browser.
  • Share a direct chat experience with users.

3.4 Embedding the Livechat widget

You’ll see a snippet similar to:

<script type="module" src="https://app.chatigram.com/livechat/web-js-sdk.js?token=YOUR_TOKEN"></script>

Paste it in your website’s <head> section. The widget will appear using the appearance defined for this line.

4. Inbox

4.1 Conversation list

The left side of the Inbox shows:

  • All conversations for your organization.
  • Last message preview.
  • Status (Pending, In Progress, Closed, etc.).
  • Line/channel information.

4.2 Conversation view

Clicking a conversation opens the full message history:

  • User messages.
  • Workflow messages (marked as “Workflow”).
  • Status updates.

4.3 Filters

You can filter chats by:

  • Line / channel type.
  • Status.

4.4 Manual replies

Use the message box at the bottom to manually respond to the user, even if workflow automation is active. This is ideal for escalations or edge cases.

5. Conversation statuses

5.1 Defaults

Common default statuses include:

  • Pending
  • In Progress
  • Closed

5.2 Managing statuses

  1. Go to Settings → Conversation statuses.
  2. Create new statuses, rename or recolor existing ones.
  3. Set a default status for new chats.

5.3 Updating status via workflows

Use the Update Conversation Status node to change the status automatically as the workflow progresses (e.g. mark as Closed after a final message).

6. Billing & plans

Under Manage billing you can review your current plan and limits. Plans vary by:

  • Number of active lines.
  • Number of enabled workflows.
  • Other feature or usage differences.

You can adjust plans as your organization grows or your automation needs change.

7. Organization

7.1 Organization structure

In Chatigram, every user can create one organization of their own, but they can join multiple organizations as either an Admin or a Member.

  • Admin:
    • Full access to organization settings.
    • Can manage lines, workflows, billing, and members.
    • Can view and manage all conversations.
  • Member:
    • Focused on support and communication.
    • Access to the Inbox and assigned conversations.
    • Ideal for support agents and operators.

7.2 Organization settings

The Organization area allows you to manage:

  • General workspace profile (name, branding).
  • Members and roles.
  • Billing ownership and visibility.

7.3 Leaving an organization

From the General tab, you can choose Leave organization, which removes your access to that workspace. You can still participate in other organizations you are part of.

8. Workflows overview

Workflows define how Chatigram reacts to triggers and how it moves through different steps and decision points.

  • Each workflow has one trigger.
  • Workflows consist of nodes connected in sequence or branches.
  • They use variables and workflow properties as data.

8.1 Creating workflows

You can create workflows in three ways:

  1. Blank workflow
    Choose a trigger and build the flow step-by-step in the editor.
  2. Official Templates
    Start from pre-built workflows such as:
    • Business Connect Agent – ideal for websites, help desks, internal tools, or client-facing platforms.
    • Profile Connect Agent – perfect for freelancers, creators, consultants, and professionals who want to stay responsive without being online all the time.
    New templates are being added over time, so you can quickly launch common patterns without designing every node from scratch.
  3. Copy Existing Workflow Duplicate
    Duplicate an existing workflow from the list, then rename and adjust it. This is ideal when creating variants for new languages, brands, or slightly different flows.

8.2 Workflow editor

The workflow editor is a visual canvas. At the top you typically see a trigger node, followed by message, AI, condition, and integration nodes.

  • Click any node to edit it in the right sidebar.
  • Use the + connector below a node to attach the next step.
  • Use branching nodes like Check Condition and Ask multiple choice to split logic.

9. Workflow properties

Workflow properties are global fields configured in the workflow editor sidebar under Properties. They:

  • Are not shown directly to users.
  • Act as training content for AI or reusable text blocks.

9.1 Properties from official templates

Official templates often define example properties such as:

  • About (for AI Training)
  • Services & Products (for AI Training)
  • FAQ (for AI Training)
  • How to connect
  • Ask for name

You can freely edit or remove these, or add new custom properties for your use case.

9.2 Creating custom properties

  1. Open the workflow in the editor.
  2. In the sidebar, open the Properties section.
  3. Click Add property.
  4. Fill in:
    • Label – display name (e.g. “Company mission (AI Training)”).
    • Info – short description for editors.
    • Value – the content itself.
    • Required – if it must be filled.

9.3 Using properties with AI

In an Ask AI node, use the variables picker to insert properties into the System content. This gives the AI background knowledge about your business while keeping your prompts short and maintainable.

10. Variables

Variables store data for a single workflow run. They can come from:

  • User input (Receive text, Multiple choice answers).
  • Node outputs (Ask AI, External API, Verify Email, etc.).
  • Workflow properties.
  • Set Variable nodes.

10.1 Using variables

Where a field shows a Variables dropdown, click it to insert any available variable. At runtime, Chatigram replaces the placeholder with the actual value.

10.2 Naming guidelines

  • Use descriptive names like user_name or selected_plan.
  • Avoid generic names like data1 for important variables.
  • Keep naming consistent across workflows.

11. Multi-language support

With Automatic translations, a single workflow can serve users in many languages.

11.1 Enabling translations

  1. Open your workflow in the editor.
  2. In the sidebar, find Multi-language support.
  3. Enable Automatic translations.
  4. Configure the Language selection message.
  5. Set a Default language and add Other languages.

11.2 User experience

When users start a chat, they will see a language selection question with buttons. Once they choose a language, messages are translated between their language and your default language automatically.

12. Node reference

The following sections summarize primary node types in Chatigram workflows.

12.1 Trigger nodes

  • Conversation Start – runs when a conversation begins.
  • New Chat Created – runs when the first message of a new chat is received.
  • New Text Message – runs when a message matches configured criteria.
  • Chat Status Change – runs when a conversation’s status changes.
  • Webhook – runs when an external system calls a generated URL.
  • Scheduler / Cron – runs based on a time schedule.

12.2 Input nodes

Input nodes collect information from users during a conversation.

Receive Text Message

Pauses the workflow until the user sends their next message. The message is stored in a variable that you can use later (for AI, APIs, or conditional checks).

Fields:

  • Variable name – where to store the user's message
  • Timeout (optional) – seconds to wait before continuing
Example workflow:
1. Send: "What's your name?"
2. Receive Text → store in user_name
3. Send: "Nice to meet you, {{user_name}}!"

Ask Multiple Choice Question

Displays a question with clickable option buttons. Each option can route to a different branch in your workflow.

Fields:

  • Question text – the question to ask
  • Options – list of choices (each creates a new branch)
  • Variable name – stores the selected option text

Branches: One branch per option, plus an optional timeout branch

Perfect for routing users: "What do you need? → Pricing / Support / Demo"

12.3 Action nodes

Send Text Message

Sends a chat message to the user. You can combine static text with variables to make personalized responses.

Ask Multiple Choice Question

Displays a question and a set of clickable options. Each option has its own branch so you can route users differently depending on their choice.

Send Email

Sends an email using your configured email settings:

  • To – a fixed email address or a variable.
  • Subject – supports variables.
  • Body – HTML or plain text with variables.

Verify Email

Validates an email address and optionally sends an OTP. It exposes two branches:

  • Valid – email passes validation.
  • Invalid – email fails validation.

Update Conversation Status

Changes the conversation’s status to any of your configured conversation statuses.

12.4 Control nodes

Set Variable

Assigns a value to a variable. Often used to store user choices, flags, or intermediate values.

Check Condition

Evaluates rules and routes execution to Yes or No branches. Supports:

  • equals / does not equal
  • contains / does not contain
  • begins with / ends with
  • ignore case

You can combine multiple conditions using AND/OR groups for more complex logic.

A/B Testing

Splits the flow randomly into multiple branches so you can experiment with different messages or flows.

Configuration:

  • Define 2-10 branches
  • Set percentage weight for each branch
  • Track results via conversation analytics
Test different greeting messages or AI prompts to optimize conversion rates.

Switch Case

Routes execution based on the value of a variable, similar to a switch statement in programming.

Fields:

  • Input value – variable or text to evaluate
  • Cases – define multiple case branches (e.g., "urgent", "normal", "low")
  • Default branch – executes if no cases match

Variables:

  • matchedCase – which case was selected
  • success – true/false
Example: Route based on priority: "urgent" → immediate response, "normal" → queue, "low" → automated response

Branch Selector (5, 10, 15, 20 branches)

Route workflow to one of many static branches based on numeric index or branch name. Available in 5, 10, 15, and 20 branch variants.

Fields:

  • Branch Index – numeric (0-based) or branch name ("branch 1", "branch1", case-insensitive)

Input formats:

  • Numeric: 0 → Branch 1, 1 → Branch 2, etc.
  • Name: "branch 5", "Branch 10", "BRANCH 20"

Variables:

  • selectedBranch – name of selected branch
  • success – true/false
  • error – error message if invalid input

Error handling: Invalid inputs route to automatic Error branch

Use cases: Admin command routing, multi-step form navigation, large-scale decision trees

12.5 Ask AI node

The Ask AI node sends a prompt to a configured AI model and stores the reply in a variable. The underlying model is configured internally; workflow builders do not choose the model.

Fields:

  • Node name – label shown in the editor.
  • System content – short instruction defining the AI’s role/behavior.
  • User content – the main prompt, usually including variables.
  • Response value name – variable name to store the AI reply.
Internally, Chatigram sends a chat completion request and extracts choices.0.message.content from the provider’s JSON response into the specified variable.

Example:

  • System content: “You are a helpful assistant that answers briefly and clearly.”
  • User content: “Answer the user’s question: {{user_question}}”
  • Response value name: ai_answer

12.6 External API integration node

The External API integration node calls REST APIs and lets you map response data into variables. You can use it to:

  • Call your own AI models or other model providers.
  • Integrate with business systems (CRM, ERP, ticketing tools, internal dashboards).
  • Create or update records in your own backend services.
  • Book appointments (for example with Google Calendar APIs).
  • Trigger actions in SaaS tools (e.g. marketing platforms, payment systems).
  • Method – GET, POST, PUT, DELETE, PATCH, etc.
  • URL – endpoint, supports variables.
  • Headers – e.g. Content-Type: application/json, Authorization.
  • Query parameters – appended to the URL as query string.
  • Request body – usually JSON, supports variables.

Response extraction

  • Get whole response – store entire body as text.
  • Extract JSON value – use JSONPath to extract a field.

Examples:

  • choices.0.message.content – first AI message content.
  • data.user.name – a name field inside nested JSON.

12.7 Utility nodes

Utility nodes provide safe string manipulation, data parsing, date/time operations, and memory management without requiring JavaScript execution.

String Operations

Perform safe string manipulation operations including extraction, transformation, checking, and formatting.

Fields:

  • input – the text string to operate on
  • operation – operation type (see below)
  • pattern (optional) – for split, replace, regex, contains, etc.
  • replacement (optional) – for replace operations
  • index (optional) – for substring, split, repeat
  • length (optional) – for substring, pad operations

Operations:

  • Extract: substring, split, extract_number, extract_regex
  • Transform: uppercase, lowercase, trim, replace, replace_regex
  • Check: contains, starts_with, ends_with, length, is_empty
  • Format: pad_start, pad_end, repeat, reverse, join

Variables: result, success, error

Example: Extract number from \"ban 24h\"
operation: \"extract_regex\"
pattern: \"(\\d+)h\"
→ result: \"24\"

Text Parser

Parse text using regex patterns and extract up to 5 captured groups plus the full match.

Fields:

  • text – the text string to parse
  • pattern – regex pattern with capture groups (use parentheses)
  • flags (optional) – 'i' (case-insensitive), 'g' (global), 'gi' (both)

Variables: match1, match2, match3, match4, match5, fullMatch, allMatches (JSON), success, error

Example: Extract time and unit from \"ban 24h\"
pattern: \"ban (\\d+)([hd])\"
→ match1: \"24\", match2: \"h\"

Date Calculator

Calculate dates by adding or subtracting time periods. Returns timestamp, ISO date, Unix timestamp, and human-readable date.

Fields:

  • baseDate (optional) – starting date (empty = current time, or connect Date/DateTime Picker output)
  • operation (optional) – 'add' (default) or 'subtract'
  • seconds, minutes, hours, days, weeks, months (optional) – time units to add/subtract

Variables: timestamp, unixTimestamp, isoDate, humanDate, success, error

Seamless integration: Works directly with Date Picker, Time Picker, and DateTime Picker nodes. Connect their output to baseDate field.
Example: Temporary ban for 24 hours
baseDate: (empty = now)
operation: \"add\"
hours: \"24\"
→ Use isoDate or unixTimestamp for ban expiry

JSON Parser

Parse JSON strings and extract up to 5 values using dot notation paths. Perfect for parsing API responses or Telegram rawMessage.

Fields:

  • jsonString – the JSON text to parse
  • path1-5 (optional) – dot notation paths (e.g., 'user.id', 'data.name', 'users[0].email')

Variables: value1, value2, value3, value4, value5, isValid, success, error

Example: Extract from Telegram message
jsonString: {{rawMessage}}
path1: \"from.first_name\"
path2: \"from.id\"
path3: \"message.text\"
→ Extract user info from webhook

Markdown Table Parser

Convert JSON arrays/objects to formatted markdown tables or lists with custom columns, labels, prefixes, and value replacements.

Fields:

  • jsonString – JSON array or object
  • columns – comma-separated column definitions:
    • Simple: \"status,name\"
    • Nested: \"user.first_name\"
    • Custom label: \"user.first_name:Name\"
    • With prefix: \"user.username:Username:@\" or \"user.bio:Bio:'> '\"
  • separator – column separator (default: |)
  • showIndex (optional) – add row numbers ('yes' for table format)
  • displayFormat – 'table' (markdown table) or 'list' (numbered list)
  • replaceValues (optional) – value replacements (e.g., \"true:yes,false:no,creator:owner\")

Variables: markdownTable, success, error

Perfect for sending formatted member lists, status reports, or data summaries in chat.

Memory Manager

Store and retrieve persistent data across workflow executions. Perfect for conversation context, user preferences, or state tracking.

Set Memory

Fields:

  • name – unique memory name (letters, numbers, underscore, hyphen, max 50 chars)
  • action – 'overwrite' (replace all) or 'append' (add to top with timestamp)
  • data – text content to store
  • addTimestamp – 'true' (default) adds date/time prefix, 'false' stores only data

Variables: success, message

Get Memory

Fields:

  • name – memory name to retrieve

Variables: data, exists (true/false), lastUpdated

Important: Memory nodes only work in webhook-triggered and cron-triggered workflows (not manual/test runs). Memories auto-delete after 7 days of inactivity.

Date/Time Pickers

Interactive date and time selection nodes that display calendar/time pickers to users.

  • Date Picker – calendar selection, returns ISO date
  • Time Picker – time selection, returns HH:mm format
  • DateTime Picker – combined date and time selection, returns ISO datetime

Variables: Selected date/time in ISO format, timestamp, human-readable format

All picker outputs work seamlessly with Date Calculator node for advanced date operations.

Validation Nodes

  • Validate Email – check email format, optionally send OTP
  • Validate Pattern – validate against regex patterns (phone, ID, custom formats)
  • Name Validator – validate names with configurable rules

All validation nodes expose Valid and Invalid branches for easy error handling.

Other Utility Nodes

  • Calculate Expression – evaluate mathematical expressions safely
  • Generate Secret – create secure random strings (tokens, passwords, IDs)
  • Extract Webpage – fetch and extract content from web pages
  • Summarize Text – create summaries of long text content

13. App Connections & Automations

Connect your business apps and automate workflows with Chatigram. Chatigram supports direct OAuth-based integration with Google Workspace, Telegram bots, and more.

13.1 Connecting Apps

Navigate to Settings → Integrations to connect external services:

  1. Click Connect new account
  2. Select the service (Google Calendar, Google Drive, Telegram Bot, etc.)
  3. Follow OAuth flow or provide API credentials
  4. Account appears in your integrations list with connected status
Security: All integrations use OAuth 2.0 with secure token storage. You can revoke access anytime.

13.2 Using Integrations in Workflows

Once connected, integration accounts are available in workflow nodes via Account field dropdowns. Select the connected account to perform actions.

13.3 Google Workspace Integrations

Chatigram provides comprehensive Google Workspace integration with nodes for Calendar, Drive, Docs, Sheets, and Gmail.

Google Calendar

Available nodes:

  • Create Event – create calendar events with title, description, start/end times, attendees
  • List Events – retrieve upcoming events with filtering
  • Update Event – modify existing events
  • Delete Event – remove calendar events
  • Find Available Slots – check calendar availability for booking workflows
Perfect for appointment booking, meeting scheduling, and calendar automation from chat.

Google Drive

Available nodes:

  • Upload File – upload any file (PDF, image, doc) with Base64 or plain text content
  • Create Google Doc – create new Google Doc with content
  • Create Google Sheet – create new spreadsheet with data
  • Read File – download and read file content
  • Export File – export Docs/Sheets to PDF, DOCX, XLSX, CSV, etc.
  • List Files – list files from Chatigram folder or specific folder
  • Update File – update file content
  • Delete File – permanently delete files
  • Create Folder – create custom folders

Features:

  • Auto-creates "Chatigram" folder for organization
  • Caches folder IDs for performance
  • Supports Base64 and plain text content
  • Auto-detects MIME types

Google Docs (Advanced)

Available nodes:

  • Create Document – create blank Google Doc
  • Insert Text – insert text at specific position
  • Read Document – extract plain text content
  • Replace Text – find and replace with case-sensitive option
  • Delete Text – delete text range
  • Format Text – apply bold, italic, underline formatting
  • Insert Image – insert images from URL
  • Create Table – insert tables with custom rows/columns

Google Sheets (Advanced)

Available nodes:

  • Create Spreadsheet – create new spreadsheet
  • Write Data – write to specific cells (A1 notation, supports formulas)
  • Read Data – read cell ranges or entire sheets
  • Append Data – append rows to end of sheet
  • Clear Range – clear data from cell range
  • Add Sheet – add new sheet/tab to spreadsheet
  • Delete Sheet – remove sheet by ID
  • Format Cells – apply bold, italic, background colors
  • Get Info – retrieve spreadsheet metadata and sheet list

Gmail

Available nodes:

  • Send Email – send emails with HTML/plain text, attachments
  • List Messages – retrieve inbox messages with filtering
  • Read Message – get full message content including attachments
  • Search Messages – search with Gmail query syntax

13.4 Telegram Bot Integrations

Build powerful Telegram bots with full API support for messaging, media, polls, admin controls, and more.

Messaging Nodes

  • Send Message – text messages with HTML/Markdown formatting
  • Send Photo – send images with captions
  • Send Document – send files and documents
  • Send Video – send video files with streaming support
  • Send Audio – send audio/music tracks
  • Send Voice – send voice messages
  • Send Video Note – send round video messages
  • Send Location – send GPS coordinates
  • Send Contact – send contact cards
  • Send Poll – create native polls and quizzes

Message Management

  • Edit Message Text – edit previously sent messages
  • Edit Message Caption – edit media captions
  • Delete Message – delete messages (up to 48 hours old)
  • Forward Message – forward between chats
  • Copy Message – copy without \"forwarded from\" label
  • Pin Chat Message – pin important messages
  • Unpin Chat Message – unpin specific or most recent
  • Unpin All Messages – remove all pins

User & Group Management

  • Ban Chat Member – ban users with optional time limit
  • Unban Chat Member – unban previously banned users
  • Restrict Chat Member – limit user permissions (send messages, media, polls, etc.)
  • Promote Chat Member – promote to admin with custom rights
  • Get Chat Member – get detailed member information
  • Get Chat Administrators – list all admins
  • Get Chat Member Count – total member count
  • Set Admin Custom Title – custom admin titles (e.g., \"Manager\", \"Moderator\")

Chat Configuration

  • Set Chat Title – change group/channel title
  • Set Chat Description – update description
  • Set Chat Photo – update chat photo from URL
  • Delete Chat Photo – remove current photo
  • Set Chat Permissions – set default member permissions
  • Get Chat – retrieve chat information and settings
  • Send Chat Action – show typing, upload_photo, etc. indicators

Invite Links & Join Requests

  • Export Invite Link – generate new primary invite link
  • Create Invite Link – create custom links with expiry, member limit, approval requirement
  • Revoke Invite Link – invalidate specific invite link
  • Approve Join Request – approve pending join requests

Interactive Features

  • Send Inline Keyboard – messages with clickable button rows
  • Answer Callback Query – respond to button clicks with notifications or alerts
  • Stop Poll – close active poll and get results

Webhook & Automation

  • Set Webhook – configure webhook URL for receiving updates
  • Get Webhook Info – check webhook status and pending updates
  • Delete Webhook – remove webhook configuration
  • Get Chat ID – retrieve chat IDs from recent messages (up to 5 unique chats)
  • Get Received Message – retrieve messages via webhook (perfect for cron workflows)

Forum Features

  • Create Forum Topic – create topics in forum supergroups
  • Close Forum Topic – close open topics

File Management

  • Get File – get file info and download URL from file_id
  • Get User Profile Photos – retrieve user's profile pictures
Pro tip: Use \"Get Received Message\" node with cron trigger to check for new messages periodically without API conflicts. Mark messages as processed to track which ones you've already handled.

13.5 Automation Best Practices

  • Test with sample data – always test integrations with dummy data before going live
  • Use variables – make content dynamic by inserting user input and workflow variables
  • Error handling – use branch nodes to handle API errors gracefully
  • Check integration status – monitor integration dashboard for connection issues
  • Rate limits – respect API rate limits (especially with cron triggers)
  • Security – never expose API keys or sensitive data in messages

13.6 Example Automation Flows

Example 1: Appointment Booking
1. User requests appointment via chat
2. Ask AI → extract preferred date/time
3. Find Available Slots (Google Calendar) → check availability
4. Check Condition → if slot available
5. Create Event (Google Calendar) → book appointment
6. Send confirmation message with event details
Example 2: Document Generation
1. Collect user information (name, details, etc.)
2. Create Google Doc → generate document from template
3. Insert Text → fill in user data
4. Format Text → apply formatting
5. Upload to Drive or export as PDF
6. Send download link to user
Example 3: Telegram Group Management
1. Receive message via webhook (Get Received Message)
2. Text Parser → extract command and user ID
3. Switch Case → route based on command
4. Branch: \"ban\" → Ban Chat Member (with Date Calculator for duration)
5. Branch: \"promote\" → Promote Chat Member with admin rights
6. Send confirmation message
Example 4: Data Sync to Sheets
1. Webhook trigger → receive data from external system
2. JSON Parser → extract relevant fields
3. Markdown Table Parser → format for preview
4. Append Data (Google Sheets) → add row to tracking sheet
5. Send Email → notify team
6. Send Telegram notification with formatted summary

14. External API integration – example

Goal: Fetch a user’s profile from an external API and greet them.

  1. Add an External API integration node.
  2. Method: GET.
  3. URL: https://api.example.com/users/{{user_id}}.
  4. Headers: add any required auth headers (e.g. Authorization).
  5. Add a JSON value extractor:
    • Variable name: user_name
    • JSONPath: data.name
  6. Connect a Send Text Message node:
    • Message: “Hi {{user_name}}, welcome back! How can I help you today?”

You can use the same pattern to:

  • Create a booking by calling a Google Calendar API endpoint.
  • Push leads into your CRM when a user shares contact details.
  • Start a workflow in your internal systems whenever a chat reaches a specific step.

14. Example workflows

14.1 Simple greeting assistant

  1. Trigger: Conversation Start.
  2. Node: Send Text Message – “Hi! How can I help you today?”

14.2 Multi-language welcome assistant

  1. Enable Automatic translations in the workflow settings.
  2. Trigger: New Chat Created.
  3. Ask Multiple Choice: “What do you need help with?” (e.g. “Pricing”, “Support”, “Other”).
  4. Route each choice to separate branches or Ask AI nodes.

14.3 FAQ assistant using Ask AI + properties

  1. Start from an official FAQ-style template or add properties:
    • About (for AI Training)
    • Services & Products
    • FAQ
  2. Trigger: New Text Message.
  3. Ask AI:
    • System content: include About/Services/FAQ properties via variables.
    • User content: user’s message variable.
    • Response variable: ai_answer.
  4. Send Text Message: “{{ai_answer}}”.

14.4 Duplicate and customize a workflow

  1. Open the Workflows page and find a workflow that already works well.
  2. Use the Copy / Duplicate action.
  3. Rename the copy (e.g. “Profile Assistant – ES”).
  4. Update:
    • Workflow properties (About, FAQ, etc.).
    • Language settings.
    • Nodes/messages for the new variation.

15. Troubleshooting

15.1 Workflow doesn’t trigger

  • Check that the workflow is Enabled in the editor sidebar.
  • Ensure the trigger type matches your scenario (message vs. status vs. webhook).
  • Confirm that the workflow is allowed on the Line (Lines → Allowed workflows).

15.2 Variables are empty

  • Verify that the node responsible for the variable executed before it’s used.
  • Check JSONPath expressions in External API nodes.
  • Ensure variable names are spelled correctly everywhere.

15.3 External API errors

  • Double-check endpoint URLs and HTTP methods.
  • Verify headers (Authorization, Content-Type) and body format.
  • Use node logs to inspect error messages returned by the API.

15.4 AI node issues

  • Ensure both System content and User content are set.
  • Keep system instructions concise and clear.
  • Constrain answer length when needed (e.g. “Answer in 3 bullet points”).

15.5 Widget not loading

  • Make sure the script is in your site’s <head>.
  • Confirm the line is connected and active.
  • Check the browser console for JavaScript errors.

15.6 Integration connection issues

  • Check integration status in Settings → Integrations.
  • Re-authenticate if token has expired (OAuth tokens may need renewal).
  • Verify you've granted all required permissions during OAuth flow.
  • For Google integrations, ensure the Chatigram folder hasn't been deleted.
  • Check API quota limits if operations fail intermittently.

15.7 Telegram bot issues

  • Bot not responding: Check webhook is configured correctly (Set Webhook node).
  • Permission errors: Ensure bot has admin rights in the group/channel.
  • Chat ID missing: Use Get Chat ID node to retrieve correct chat IDs.
  • Get Received Message returns nothing: Ensure webhook is active and messages are being received.
  • Rate limits: Telegram has message rate limits (30 messages/second to same chat).

15.8 Utility node errors

  • String Operations: Check operation name spelling, verify pattern syntax for regex operations.
  • Text Parser: Escape special regex characters, check parentheses for capture groups.
  • Date Calculator: Verify baseDate format (ISO, Unix timestamp, or empty for now).
  • JSON Parser: Ensure jsonString is valid JSON, check path syntax (use dot notation and [index] for arrays).
  • Memory nodes: Only work in webhook/cron triggers (not manual/test runs), memory auto-deletes after 7 days of inactivity.

15.9 Performance optimization

  • Minimize External API calls in loops or high-frequency triggers.
  • Cache frequently accessed data using Memory nodes or workflow properties.
  • Use Check Condition nodes to skip unnecessary operations.
  • For cron triggers, avoid running every minute unless absolutely necessary.
  • Batch operations instead of multiple individual writes.

16. Glossary

  • Line – a communication channel (Livechat, Telegram, WhatsApp, Instagram, etc.).
  • Workflow – a visual automation built from nodes.
  • Node – a single step in a workflow.
  • Trigger – an event that starts a workflow.
  • Workflow property – global field used as configuration or AI training content.
  • Variable – a runtime value used within a workflow.
  • JSONPath – syntax for extracting values from JSON responses (e.g., 'data.user.name').
  • A/B Testing – randomly splitting traffic into multiple branches to test variations.
  • Branch – a conditional path in a workflow where execution can diverge.
  • OAuth – secure authentication protocol used for connecting external apps (Google, Telegram, etc.).
  • Integration – connected external service account (Google Calendar, Drive, Telegram Bot, etc.).
  • Webhook – HTTP endpoint that receives real-time notifications from external systems.
  • Cron – time-based job scheduler for running workflows on a schedule.
  • Memory – persistent storage for data across workflow executions (7-day retention).
  • Utility Node – safe data processing node (String Operations, Date Calculator, JSON Parser, etc.).
  • ISO Date – standard date format (e.g., 2024-12-21T15:30:00Z) used by most APIs.
  • Unix Timestamp – seconds since January 1, 1970 (epoch time).
  • Regex – regular expression pattern for text matching and extraction.
  • Markdown – lightweight formatting syntax for text (used in tables, lists, formatting).
  • Base64 – encoding scheme for binary data as text (used for file uploads).
  • MIME Type – standard that indicates file type (e.g., application/pdf, image/png).
  • A1 Notation – spreadsheet cell reference format (e.g., Sheet1!A1:C10).
  • Chat ID – unique identifier for Telegram chats (users, groups, channels).
  • Inline Keyboard – clickable buttons attached to Telegram messages.
  • Callback Query – response triggered when user clicks inline keyboard button.