Troubleshooting Workflows
Workflow not doing what you expect? This guide covers the most common issues and how to fix them. Bookmark this one - it will save you time.
Workflow Not Running
- Is it published? Workflows in draft mode do not process any posts. Make sure you have clicked Publish.
- Check the trigger - Verify the trigger is set correctly (e.g., "Post Created") and connected to the right Listening search.
- Is Listening finding posts? If your Listening search has no results, there is nothing for the workflow to process. Check your search terms and filters.
Agent Node Not Filtering Correctly
- Review your prompt - Is it specific enough? Vague prompts give inconsistent results.
- Check the output format - If your IF condition expects "yes" but the Agent outputs "Yes, this matches," the condition will fail. Specify the exact output format in your prompt.
- Test manually - Run a few sample posts through the Agent to see what it outputs before relying on it in production.
HTTP Request Node Failing
- Check the URL - Make sure the webhook URL is correct and the destination service is running.
- Verify JSON format - A missing comma, bracket, or quote will cause the request to fail. Use a JSON validator if needed.
- Check response codes - Look at the error in the logs. A 401 means auth issues. A 400 means bad request format. A 500 means the destination server has a problem.
Slack Not Receiving Messages
- Verify the Slack connection - Go to Settings > Integrations and confirm Slack is still connected.
- Check channel permissions - The Trigify bot needs to be added to the channel you are sending to.
- Test the node - Use the test function to send a sample message and see if it arrives.
Low or No Results
- Check Listening first - If Listening is not finding posts, the workflow has nothing to process.
- Verify trigger matches - Make sure the workflow trigger aligns with the Listening search that is generating posts.
- Agent too strict? - If your Agent node is filtering out everything, loosen the criteria or check the prompt.
Using Logs to Debug
Every workflow run is logged. Go to your workflow and click Logs to see:
- Which posts entered the workflow
- What each node did with the post
- Where a post was filtered out or where an error occurred
A red node in the logs means that step failed. Click on it to see the error message and response details.
Testing Individual Nodes
You do not need to run the entire workflow to test. Click on any node and use the Test button to run it with sample data. This is the fastest way to isolate issues.
When to Contact Support
If you have checked all of the above and the issue persists, reach out to our support team. Include:
- Your workflow name/ID
- The specific error message from the logs
- What you expected to happen vs. what actually happened