​
Webhook Triggers

Webhook triggers enable you to initiate agent tasks through HTTP requests from external systems. This powerful integration method allows you to connect virtually any third-party service to your Relevance AI agents without requiring native support.

​
Key Features

  • Custom Webhook URLs: Each webhook trigger provides a unique URL that receives incoming requests and activates your agent.
  • Flexible Payload Formatting: You have complete control over how incoming data is processed. Use template variables with double brackets (e.g., {{first_name}}) to personalize messages or include the entire payload with {{$}}.
  • Thread ID Mapping: For continuous conversations, map a specific field from your payload to serve as a Thread ID. This ensures new information is added to the same agent conversation, perfect for chatbot implementations.
  • Duplicate Prevention: Map a Unique ID field to prevent processing the same event multiple times, ensuring data integrity and avoiding redundant operations.

​
Setting Up a Webhook Trigger

  1. Navigate to your agent’s settings and select the Triggers section
  2. Choose “Webhook Trigger” from the available options
  3. Configure your webhook settings:
    • Customize the message template using variable placeholders
    • Map Thread ID and Unique ID fields as needed
    • Copy your unique webhook URL for integration with external systems

​
Implementation Examples

Webhook triggers can be used for various automation scenarios:
  • Trigger customer support responses when new tickets are created
  • Process form submissions from your website
  • Respond to events from third-party platforms
  • Create automated workflows between different systems
Core Instructions - Define how your agent should process and respond to webhook triggers by setting up comprehensive instructions that guide its behavior when receiving external data. Flow Builder - Create sophisticated workflows that can be initiated by webhook triggers, allowing for complex multi-step processes that combine different tools and decision points.

​
FAQs

Q: Can I use webhook triggers with any external system? A: Yes, any system capable of sending HTTP requests can integrate with Relevance AI’s webhook triggers, making them extremely versatile for various integration scenarios. Q: How secure are webhook triggers? A: Webhook triggers use unique URLs that are difficult to guess. For additional security, you can implement Unique ID mapping to prevent duplicate processing and validate incoming requests. Q: What happens if the same webhook is triggered multiple times? A: By mapping a Unique ID field, you can prevent duplicate processing. If an event with the same Unique ID is received again, it will be ignored, ensuring data integrity. Q: Can I use Zapier as a Workforce trigger? A: Yes! Zapier is available as an external trigger in Workforces. External triggers are not managed by Relevance AI. This trigger is configured through Zapier.