Integrate Swiftask webhook with Odoo CRM

Written By Stanislas

Last updated 1 day ago

Overview

This guide walks you through integrating Swiftask with Odoo CRM using webhook triggers. When a new lead is created in Odoo, a webhook automatically notifies your Swiftask agent, which can then process the information and take automated actions.

Webhook integration is ideal when you want external systems (like Odoo CRM) to trigger your Swiftask agent's automation without manual intervention. The webhook acts as a bridge between the two platforms, passing lead data from Odoo directly to Swiftask.

Prerequisites

Before you start, ensure you have:

  • Swiftask workspace access: You must have permission to create automations and triggers within your Swiftask workspace.

  • Swiftask agent configured: Your agent should have clear objectives and any necessary skills (like sending emails or logging data).

  • Odoo CRM instance: Access to an Odoo CRM workspace with administrative permissions to configure automations.

  • Odoo developer mode enabled: You'll need to activate developer mode to access Odoo Studio and automation settings.

  • Basic understanding of webhooks: Familiarity with how webhooks work (HTTP POST requests triggering automations) is helpful but not required.

Step-by-Step Guide

Part 1: Create the webhook trigger in Swiftask

Step 1 – Access the Triggers section

Navigate to your agent configuration in Swiftask.

  1. In the left sidebar, under the Automations section

  2. Select Triggers (marked as NEW)

  3. You'll see a list of any existing triggers for this agent

Step 2 – Create a new webhook trigger

Click the New Trigger button (red button with + icon).

A dialog opens showing different trigger type options.

  1. Look for the Webhook option in the list

  2. Read the description: "Trigger via HTTP webhook URL. Perfect for integrating with external services."

  3. Click Webhook to select it

Step 3 – Configure the webhook trigger

The dialog advances to the configuration step.

  1. Enter a descriptive Trigger Name in the input field (example: "Odoo Lead Creation" or "New CRM Lead Notification")

  2. This name will appear in your triggers list and logs, so make it specific to this integration

  3. The system explains: "After creating this trigger, you'll receive a unique webhook URL that you can use to trigger your automation from any external service."

Step 4 – Review and create the trigger

After entering the trigger name, click Next.

The dialog advances to a review step where you'll see:

  • Trigger type: Webhook

  • Description: "Trigger via HTTP webhook URL. Perfect for integrating with external services."

  • Trigger Name: Your entered name

Review the information to ensure it's correct, then click the red Create Trigger button.

Step 5 – Copy your webhook URL

Once the trigger is created, you'll be returned to the Triggers list and your new webhook trigger now appears with status "Active".

  1. Click on your newly created trigger to open its details panel

  2. Locate the Webhook URL (POST) field

  3. Copy the full URL—this is what Odoo will call to trigger your automation

Your webhook URL looks like this:

https://graphql.swiftask.ai/api/agent-automation/webhook/[unique-id]

The details panel also shows:

  • ID: Unique identifier for this trigger

  • Type: WEBHOOK

  • Status: Active (or Inactive if toggled off)

⚠️ Important: Save this URL somewhere safe—you'll paste it into Odoo Studio in the next section.

Part 2: Enable developer mode in Odoo

Step 6 – Access Odoo settings

Navigate to your Odoo CRM workspace.

  1. Go to CRM module

  2. Click Configuration (in the left menu)

  3. Select Settings

Step 7 – Activate developer mode

In the Settings page, you'll see various configuration options.

  1. Search for "developer" in the search field or scroll to find the developer mode option

  2. Click Activate the developer mode button

  3. Developer mode is now enabled; you'll notice the interface changes slightly and new options appear

Developer mode is required to access Odoo Studio, where you'll set up the automation that calls your Swiftask webhook.

Part 3: Create the automation in Odoo Studio

Step 8 – Toggle Odoo Studio

Return to the Odoo CRM module.

  1. Look for the Toggle Studio button in the top-right corner of the screen

  2. Click it to enter Studio mode

Studio is Odoo's visual automation builder. Once enabled, you'll see a new interface with tabs for designing automations.

Step 9 – Open the Automations tab

Once in Studio, you'll see a tab bar at the top.

  1. Click the Automations tab

  2. You'll see a list of existing automations (if any)

  3. Click the New button to create a new automation rule

Step 10 – Configure the automation trigger

A form appears where you'll configure when this automation should run.

  1. Model: Select Lead from the dropdown (this specifies that the automation applies to lead records)

  2. Trigger: Select On create from the dropdown (this means the automation runs whenever a new lead is created)

Important: The Model must be "Lead" and the Trigger must be "On create" for the automation to fire when new opportunities are added to your CRM.

Step 11 – Add the webhook action

Now you'll specify what happens when a lead is created.

  1. Click the Add an action button

  2. A dialog appears with action type options

  3. In the Type dropdown, select Send Webhook Notification

Step 12 – Configure the webhook action

The action configuration form appears.

  1. URL field: Paste the webhook URL you copied from Swiftask in Step 5

    The URL should look like: https://graphql.swiftask.ai/api/agent-automation/webhook/[unique-id]

  2. Fields section: Click the dropdown and select Active (Lead)

    This tells Odoo to send the lead's active status data to Swiftask

  3. Leave other fields at their defaults

Step 13 – Save the automation

Once you've configured the webhook action:

  1. Click Save & Close to save the automation rule

  2. You're returned to the Automations list in Studio

  3. Your new automation rule now appears in the list

Part 4: Test the integration

Step 14 – Test by creating a new lead

Now it's time to verify the integration works.

  1. Exit Studio by clicking the Toggle Studio button again to return to normal CRM view

  2. Create a new lead in your CRM as you normally would

  3. Fill in the lead details (name, email, company, etc.)

  4. Save the new lead

When you save the lead, Odoo will automatically send a POST request to your Swiftask webhook URL, triggering your agent.

Step 15 – Verify webhook execution in Swiftask

To confirm the integration is working:

  1. Go back to Swiftask

  2. In your agent configuration, click Usage history (usually located in the left sidebar at the bottom)

  3. Click on Swiftask to view agent execution logs

  4. Look for recent webhook calls in the conversation history

If the integration is working correctly, you should see:

  • A new entry in the usage history corresponding to when you created the lead

  • The webhook call details showing the data received from Odoo

Success indicator: If you see webhook calls logged in your Swiftask usage history, the integration is working correctly. Your agent will now automatically trigger whenever a new lead is created in Odoo.

Practical Use Cases

Use case 1: Automatic lead enrichment

Scenario: When a new lead arrives in Odoo, you want Swiftask to automatically research the company and enrich the lead profile with additional information.

Setup: Configure your Swiftask agent with skills to search the web and update Odoo records. Set up the webhook integration as described above.

Result: Every new lead is automatically enriched with company research, industry data, and contact information before your sales team reviews it. This saves time and ensures consistent lead quality.

Use case 2: Instant lead notification and routing

Scenario: Your sales team needs to be notified immediately when high-priority leads are created, and leads should be automatically routed to the correct sales representative.

Setup: Configure your Swiftask agent to analyze lead data and send email notifications to team members. Use the webhook to trigger this workflow.

Result: Leads are categorized and routed instantly, with team members receiving notifications before the lead even appears in their dashboard. No manual routing needed.

Use case 3: Lead qualification automation

Scenario: You want to automatically qualify leads based on company size, industry, and budget before your sales team contacts them.

Setup: Configure your Swiftask agent to evaluate lead data against your qualification criteria and update the lead record with a qualification score.

Result: Your sales team only sees pre-qualified leads with scores, allowing them to focus on high-value prospects. Unqualified leads are logged for future follow-up.

Use case 4: CRM data validation

Scenario: Ensure all new leads have complete and valid information before they enter your sales pipeline.

Setup: Configure your Swiftask agent to validate email addresses, phone numbers, and company information. Flag incomplete records for manual review.

Result: Your CRM stays clean with only valid, complete lead records. Invalid or incomplete entries are caught before they clutter your pipeline.

Tips & Best Practices

Use descriptive trigger names: Name your webhook trigger something specific like "Odoo Lead Creation" rather than "Webhook 1". This makes it easy to identify the trigger's purpose when reviewing logs.

Test with a single lead first: Before relying on the integration, create a test lead in Odoo and verify that Swiftask receives it. Check the usage history to confirm the webhook was called successfully.

Secure your webhook URL: Treat your webhook URL like a password. Don't share it publicly or commit it to version control. If your webhook URL is compromised, delete the trigger and create a new one.

Configure meaningful agent instructions: Your Swiftask agent should have clear instructions on what to do when a lead arrives. Vague instructions may result in inconsistent or unexpected behavior.

Monitor webhook execution: Regularly check your Swiftask usage history to ensure webhooks are being received and processed. If webhooks suddenly stop arriving, check that your Odoo automation is still active and enabled.

Send complete lead data: In Odoo, make sure your automation sends all relevant lead fields to Swiftask (name, email, company, phone, etc.). Incomplete data will limit what your agent can do.

Use meaningful field selection: In Odoo's webhook action, select the lead fields that matter most to your workflow. Don't send unnecessary data—this reduces payload size and improves performance.

Troubleshooting

Webhook created but Swiftask doesn't receive calls

Cause: The Odoo automation may not be active or the webhook URL may be incorrect.

Fix:

  1. Verify the webhook URL in Swiftask (Step 5) matches exactly what you pasted into Odoo (Step 12)

  2. In Odoo Studio, check that your automation rule is enabled (should show a green toggle)

  3. Create a test lead to trigger the automation

  4. Check Swiftask usage history to see if the webhook was received

Odoo automation doesn't appear in the list

Cause: Developer mode may not be fully activated, or you may not have saved the automation correctly.

Fix:

  1. Verify developer mode is active in Odoo Settings (Step 7)

  2. In Studio, ensure you clicked Save & Close (not just Save) after configuring the action

  3. Refresh the page and check the Automations list again

  4. If still missing, recreate the automation from scratch

Webhook received but agent doesn't respond

Cause: Your Swiftask agent may not have the necessary instructions or skills configured.

Fix:

  1. Review your agent's objectives and instructions—they should clearly state what to do when a lead arrives

  2. Verify your agent has the necessary skills configured (email sending, database updates, etc.)

  3. Check the agent's execution logs to see error messages

  4. Update the agent's instructions to be more specific and detailed

"Invalid webhook URL" error in Odoo

Cause: The URL may have been copied incorrectly, or there may be extra spaces or characters.

Fix:

  1. Go back to Swiftask and copy the webhook URL again (Step 5)

  2. Paste it into Odoo's URL field, ensuring no extra spaces before or after

  3. Verify the URL starts with https:// and contains the unique ID

  4. Test the URL by creating a new lead

Multiple webhooks are being triggered

Cause: You may have accidentally created duplicate automation rules in Odoo.

Fix:

  1. Go to Odoo Studio → Automations tab

  2. Look for duplicate rules with the same name or configuration

  3. Delete any duplicate rules by clicking the trash icon

  4. Keep only one automation rule for lead creation

Additional Resources

Summary

You've successfully integrated Swiftask with Odoo CRM using webhook triggers. Your agent now automatically receives notifications whenever a new lead is created, allowing you to automate lead enrichment, routing, qualification, and validation workflows.

The integration runs silently in the background; no manual intervention needed. Every time a new lead appears in Odoo, your Swiftask agent springs into action according to its configured instructions.

For troubleshooting or questions, refer to the sections above or consult your Swiftask documentation.