App Triggers

What are Trigger?

App Trigger let your Agent automatically start when external systems or services emit events. These integrations make your automation truly seamless—your Agent doesn’t just wait for manual input, it reacts to real-world triggers across your tech stack.


Types of Trigger Integrations

You can activate your Agents in many ways through integrations:

  • Pre-built Integrations: Connect your Agent to widely used services (e.g., email, CRM, Slack) and set it to react when events occur.

  • Custom Webhook/API Triggers: If you use a system that isn’t natively integrated, you can use a webhook or API to trigger your Agent. :contentReference[oaicite:1]index=1

  • Premium Integrations: Some services may be “premium-level”, meaning they require higher subscription tiers or extra credits.

  • Schedule Triggers: If you want to trigger the agent at a particular time and day then you should use the Schedule a trigger functionality


How to Use Trigger in Arahi AI

  1. In your Agent Builder, navigate to the Triggers section.

  2. Choose Integration Trigger from the trigger types available.

  3. Select the service you want to connect (e.g., Gmail, Slack, CRM, Webhook).

  4. Authorise/Connect the external account (via OAuth, API key, etc.).

  5. Define the event that will fire the trigger (e.g., “new email received”, “new lead created”, “form submitted”).

  6. Map the payload or event fields into your Agent’s input schema (so your Agent knows how to interpret the incoming data).

  7. Optionally add filters or conditions (e.g., only trigger when label=“urgent”, only from specific sender).

  8. Save and test: send a sample event to ensure the trigger fires and the Agent receives the correct input.


Examples of Trigger

  • A new lead in your CRM triggers a LeadQualifier Agent to review and prioritise the lead.

  • A Slack message in channel #support triggers your CustomerSupport Agent to summarise and respond.

  • A webhook from your payment gateway when a transaction > $10K triggers your FinanceAudit Agent.

  • An email arriving in Gmail with subject “Invoice” triggers your InvoiceProcessor Agent to extract and route data. :contentReference[oaicite:3]index=3


Premium & Advanced Integrations

  • Some integrations (e.g., WhatsApp Business, Telegram, LinkedIn events) may be available only in higher-tier plans or incur additional usage credits.

  • For unsupported services you can always fall back to Webhook Trigger or API Trigger. This gives full flexibility even if there’s no native connector.


Best Practices

  • Ensure proper payload mapping: Make sure the fields your Agent expects are matched to the event data you receive.

  • Use filtering to avoid noise: If your trigger fires too often (e.g., every email), you might overload your Agent. Add conditions.

  • Test thoroughly: Before going live, simulate events with sample data to verify your Agent behaves correctly.

  • Monitor triggers: Track how many triggers fire, how many tasks get created, and how many succeed/fail—this helps you refine and optimise.

  • Use chronological context: For events that are part of a series (e.g., chat threads), map a Thread ID or Unique ID so your Agent can keep context. :contentReference[oaicite:9]index=9

  • Security & access control: For webhooks and APIs, protect endpoints, validate inputs, prevent duplicate triggers and ensure only authorized systems can fire your Agents.

  • Document your integrations: Keep an Integration Catalogue listing each trigger, connected service, event types, filters, and associated Agent(s).


Summary

Trigger Integrations are the “entry points” of your automation work in Arahi AI. They connect external events to Agent workflows and let your bots act when real-world things happen. By using the variety of built-in connectors, webhooks, and API options, you can create powerful, reactive systems that reduce manual work and increase responsiveness.

Updated on