[{"data":1,"prerenderedAt":267},["ShallowReactive",2],{"\u002Fdocs\u002Fconcepts\u002Fintegrations":3,"docs-navigation":192,"docs-surround:\u002Fdocs\u002Fconcepts\u002Fintegrations":264},{"id":4,"title":5,"body":6,"description":182,"extension":183,"meta":184,"navigation":185,"path":186,"seo":187,"stem":190,"__hash__":191},"docs\u002Fdocs\u002F2.concepts\u002F1.integrations.md","Integrations",{"type":7,"value":8,"toc":174},"minimark",[9,13,16,21,24,40,43,47,55,58,61,71,74,96,100,103,110,116,119,123,129,135,141,145,148,151,171],[10,11,12],"p",{},"An integration is a connected system that Gondo can use while chatting or running workflows.",[10,14,15],{},"Examples include Google Workspace, Gmail, Trello, GitHub, Jira, Notion, Airtable, SharePoint, a custom API, or a logged-in website session.",[17,18,20],"h2",{"id":19},"what-an-integration-gives-gondo","What an integration gives Gondo",[10,22,23],{},"An integration can provide:",[25,26,27,31,34,37],"ul",{},[28,29,30],"li",{},"A way to authenticate with an external system.",[28,32,33],{},"Tools for reading or writing data.",[28,35,36],{},"A stable reference ID that workflow steps can use.",[28,38,39],{},"Optional limits on which tools or toolsets are enabled.",[10,41,42],{},"For normal users, the important question is simple: \"Which connected account should this workflow be allowed to use?\"",[17,44,46],{"id":45},"reference-ids","Reference IDs",[10,48,49,50,54],{},"Each integration has a user-visible ",[51,52,53],"code",{},"referenceId",".",[10,56,57],{},"This is the stable name a workflow uses when it needs a connected app. A workflow node can list the integrations it is allowed to use, then code or agent tools can refer to that ID.",[10,59,60],{},"For example, a workflow step might use an integration named:",[62,63,69],"pre",{"className":64,"code":66,"language":67,"meta":68},[65],"language-text","finance_gmail\n","text","",[51,70,66],{"__ignoreMap":68},[10,72,73],{},"Clear reference IDs make workflows easier to understand. Prefer names that explain the account or purpose:",[25,75,76,81,86,91],{},[28,77,78],{},[51,79,80],{},"finance_gmail",[28,82,83],{},[51,84,85],{},"customer_success_trello",[28,87,88],{},[51,89,90],{},"contracts_drive",[28,92,93],{},[51,94,95],{},"supplier_portal",[17,97,99],{"id":98},"managed-oauth-and-credentials","Managed OAuth and credentials",[10,101,102],{},"Gondo supports different ways to connect.",[10,104,105,109],{},[106,107,108],"strong",{},"Managed OAuth"," is the familiar \"Sign in with...\" flow. It is usually the easiest option when available.",[10,111,112,115],{},[106,113,114],{},"Credentials"," means you provide fields such as an API key, token, service account JSON, or workspace URL. This is useful for systems that do not support managed OAuth or for enterprise-style connections.",[10,117,118],{},"Gondo stores secrets separately from workflow YAML. Do not put API keys, passwords, or tokens in workflow variables or instructions.",[17,120,122],{"id":121},"prebuilt-custom-and-browser-integrations","Prebuilt, custom, and browser integrations",[10,124,125,128],{},[106,126,127],{},"Prebuilt integrations"," are supported providers with ready-made tools. They are the easiest starting point.",[10,130,131,134],{},[106,132,133],{},"Custom API integrations"," are for HTTP APIs that Gondo does not support out of the box. They define a base URL, credential fields, and custom tools.",[10,136,137,140],{},[106,138,139],{},"Browser integrations"," are for websites where the useful action happens in the UI rather than an API. They store a logged-in browser session and let Gondo operate the site. Use browser integrations when an API is unavailable or does not cover the task.",[17,142,144],{"id":143},"tool-access","Tool access",[10,146,147],{},"An API integration can expose tools. A tool might read a document, list cards, update a spreadsheet, create an issue, or send an email.",[10,149,150],{},"Tool access can be controlled in a few ways:",[25,152,153,159,165],{},[28,154,155,158],{},[106,156,157],{},"Toolsets"," group related tools, such as Drive, Docs, Sheets, and Slides.",[28,160,161,164],{},[106,162,163],{},"Scope"," limits tools by read, write, or admin level.",[28,166,167,170],{},[106,168,169],{},"Disabled tools"," turn off individual tools for an integration.",[10,172,173],{},"For early workflows, keep access practical: enable the tools the workflow needs, and narrow access once you know the workflow is stable.",{"title":68,"searchDepth":175,"depth":175,"links":176},2,[177,178,179,180,181],{"id":19,"depth":175,"text":20},{"id":45,"depth":175,"text":46},{"id":98,"depth":175,"text":99},{"id":121,"depth":175,"text":122},{"id":143,"depth":175,"text":144},"Integrations are the connected apps, accounts, websites, and systems Gondo can use.","md",{},"[object Object]","\u002Fdocs\u002Fconcepts\u002Fintegrations",{"title":188,"description":189},"Gondo Integrations","Learn what integrations are, how reference IDs work, and how tool access is controlled.","docs\u002F2.concepts\u002F1.integrations","9vHaDCVgAwVFnCScAr7BYG6P3XWysEfXjAhkfNye8qw",[193],{"title":194,"path":195,"stem":196,"children":197,"page":-1},"Docs","\u002Fdocs","docs",[198,202,207,224,239,259],{"title":199,"path":195,"stem":200,"description":201},"Gondo Docs","docs\u002Findex","Learn the basic ideas behind Gondo, from integrations and workflows to runs, approvals, and workflow YAML.",{"title":203,"path":204,"stem":205,"description":206},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started","Connect an integration, ask Gondo for help, build a workflow, and watch it run.",{"title":208,"path":209,"stem":210,"children":211,"page":223},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002F2.concepts",[212,213,218],{"title":5,"path":186,"stem":190,"description":182},{"title":214,"path":215,"stem":216,"description":217},"Workflows","\u002Fdocs\u002Fconcepts\u002Fworkflows","docs\u002F2.concepts\u002F2.workflows","Workflows are repeatable processes made from triggers, AI tasks, code, human review, and edges.",{"title":219,"path":220,"stem":221,"description":222},"Runs and Activity","\u002Fdocs\u002Fconcepts\u002Fruns-and-activity","docs\u002F2.concepts\u002F3.runs-and-activity","Learn what happens when a workflow runs and how to read statuses, approvals, failures, and reauth pauses.",false,{"title":225,"path":226,"stem":227,"children":228,"page":223},"Guides","\u002Fdocs\u002Fguides","docs\u002F3.guides",[229,234],{"title":230,"path":231,"stem":232,"description":233},"Connect an Integration","\u002Fdocs\u002Fguides\u002Fconnect-an-integration","docs\u002F3.guides\u002F1.connect-an-integration","Add a connected app or system so Gondo can use it in chats and workflows.",{"title":235,"path":236,"stem":237,"description":238},"Build Your First Workflow","\u002Fdocs\u002Fguides\u002Fbuild-your-first-workflow","docs\u002F3.guides\u002F2.build-your-first-workflow","A practical walkthrough for turning a plain-English process into a small Gondo workflow.",{"title":240,"path":241,"stem":242,"children":243,"page":223},"Reference","\u002Fdocs\u002Freference","docs\u002F4.reference",[244,249,254],{"title":245,"path":246,"stem":247,"description":248},"Workflow YAML","\u002Fdocs\u002Freference\u002Fworkflow-yaml","docs\u002F4.reference\u002F1.workflow-yaml","The technical shape of Gondo workflow definitions, including version, run display, variables, nodes, edges, and schema rules.",{"title":250,"path":251,"stem":252,"description":253},"Node Types","\u002Fdocs\u002Freference\u002Fnode-types","docs\u002F4.reference\u002F2.node-types","Reference for trigger, task, code, and human nodes, including configs and runtime context.",{"title":255,"path":256,"stem":257,"description":258},"Integration Tools","\u002Fdocs\u002Freference\u002Fintegration-tools","docs\u002F4.reference\u002F3.integration-tools","How integration tools, toolsets, scopes, disabled tools, and custom tools fit together.",{"title":260,"path":261,"stem":262,"description":263},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002F5.troubleshooting","Fix common problems with integrations, workflow runs, human input, browser sessions, and YAML.",[265,266],{"title":203,"path":204,"stem":205,"children":-1},{"title":214,"path":215,"stem":216,"children":-1},1782191063528]