zapier-integration.mdx 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. ---
  2. title: "Zapier"
  3. description: "Learn how to integrate your agents with Zapier."
  4. icon: "circle-check"
  5. ---
  6. ## Feature Overview
  7. Zapier is a no-code automation platform that helps you connect over 7,000 apps and build automated workflows without writing any code. Integrate your **agents** with Zapier to extend their reach to countless services--responding to emails, updating spreadsheets, posting to social channels, and more.
  8. ![Screenshot 2025-05-05 at 23.02.14.png](/images/integrations/zapier-integration/Screenshot_2025-05-05_at_23.02.14.png)
  9. <Tip>To protect your privacy and that of your clients, none of your chats, conversations, or messages are stored in our database. 🔒</Tip>
  10. ## Prerequisites
  11. - **Zapier Account** ([Sign up](https://zapier.com/)).
  12. - **Platform API Key** – You can find it under **Settings → [API Keys](https://agencii.ai/settings/?tab=apiKeys)**.
  13. ## Set up Zapier
  14. <Steps>
  15. <Step title="Create a Zapier Integration (Agencii)">
  16. 1. Navigate to **Platforms** in the sidebar and select **New Platform** to begin setup.
  17. ![Screenshot_2025-05-05_at_23.22.13.png](/images/integrations/zapier-integration/Screenshot_2025-05-07_at_19.29.28.png)
  18. 2. Select **Zapier** and click on **Create Platform**.
  19. ![Screenshot_2025-05-05_at_23.22.13.png](/images/integrations/zapier-integration/Screenshot_2025-05-07_at_19.33.09.png)
  20. 3. Enter the required information for your Zapier integration, including integration name, the agent you want to connect, and a description, then click on **Save and continue**.
  21. ![Screenshot_2025-05-05_at_23.23.19.png](/images/integrations/zapier-integration/Screenshot_2025-05-07_at_19.38.05.png)
  22. </Step>
  23. <Step title="Install Zapier App on your workspace (Zapier)">
  24. The Agencii app is not yet available in the Zapier marketplace. To access it, use the **Install** button for early access.
  25. ![Screenshot 2025-02-17 at 15.40.42.png](/images/integrations/zapier-integration/Screenshot_2025-05-07_at_19.40.49.png)
  26. ![Screenshot 2025-02-17 at 15.29.05.png](/images/integrations/zapier-integration/Screenshot_2025-05-07_at_19.43.04.png)
  27. Accept the invitation to install the app & start building your automation with Agencii Zapier App✨
  28. </Step>
  29. </Steps>
  30. ![Agencii Zapier App](/images/zapier-agencii-logo.svg)
  31. ## Available Actions
  32. **Authorization**:
  33. - **Platform API Key** – Available under **Settings → [API Keys](https://agencii.ai/settings/?tab=apiKeys)**.
  34. <Card title="Prompt">
  35. <p>The <strong>Prompt</strong> action enables your agent to generate responses based on given inputs. This action processes a prompt, context, or input data and returns a response that is relevant to the context. This can be used for automating conversations, supporting decision-making, and executing tasks intelligently within workflows.</p>
  36. <ResponseField name="Action Input Properties">
  37. Understanding these properties is essential because they define how your agent will receive and interpret data from Zapier. Each property directly controls what the agent sees, what it responds to, and how it behaves in an automation.
  38. <Expandable title="properties" defaultOpen={true}>
  39. <ResponseField name="Integration ID" type="string" required>
  40. The identifier for your zapier integration, found on the integration page. Example: "HVC7YxC1YBSuTtDwGK7a"
  41. </ResponseField>
  42. <ResponseField name="Message" type="string" required>
  43. The text you want to send to the connected agent. Example: "Write a blog post with agent's knowledge"
  44. </ResponseField>
  45. <ResponseField name="Chat ID" type="string">
  46. The identifier for an existing conversation. If not provided, the system will create a new chat.
  47. </ResponseField>
  48. <ResponseField name="User Context" type="object">
  49. A JSON object with structured data (user IDs, preferences, feature flags) passed to [Agency Context](/additional-features/agency-context). This data is accessible within your agent's tools but is **not** exposed to the LLM.
  50. </ResponseField>
  51. </Expandable>
  52. </ResponseField>
  53. <ResponseField name="Action Output Properties">
  54. <Expandable title="properties" defaultOpen={true}>
  55. <ResponseField name="Integration ID" type="string">
  56. The identifier of the zapier integration used. Example: "HVC7YxC1YBSuTtDwGK7a"
  57. </ResponseField>
  58. <ResponseField name="Answer" type="string">
  59. The text response generated by your agent.
  60. </ResponseField>
  61. <ResponseField name="Chat ID" type="string">
  62. The conversation identifier - either newly created or the one you provided.
  63. </ResponseField>
  64. </Expandable>
  65. </ResponseField>
  66. </Card>
  67. <Tip>Additional actions and triggers are under development and will be added in future updates.</Tip>