🔧 Developer Hooks, Data Model And Troubleshooting

New here? Not a customer yet?See everything ResultsAiX Surveys can do, and get it.Get ResultsAiX Surveys →

Two actions fire on every completed submission, so you can wire surveys into anything.

rsv_response_recorded: Fires for every response, with the full survey array, the response id, the validated answers keyed by question id, and the email and name, where the email is empty when the visitor did not opt in. Five arguments.

rsv_lead_captured: Fires only when an email was captured, with the email, name, survey, answers and response id. The WP Sync, Mailer and autoresponder deliveries all listen to it, so anything you build on it behaves consistently. Five arguments.

An rsv_ai_error action also fires with the provider slug and message whenever an AI call fails, which is handy for logging.

rsv_bare_survey_page: A filter that decides whether a survey's own page renders in the clean, theme-free layout. It receives true, the page id and the survey id. Return false for a page and it renders inside your theme instead, with the survey shortcode in its content.

Data model:

Surveys live in the rsv_surveys table, with questions and per survey config stored as JSON, and submissions in rsv_responses, with answers as JSON plus email, name and meta. Both carry your site table prefix, and so do the AI usage log (rsv_ai_jobs) and the autoresponder delivery queue (rsv_ar_queue). Settings are in the rsv_settings option.

Uninstalling deliberately keeps your surveys, responses and settings so a reinstall never loses data. Only the Danger Zone on the Settings tab removes them, and it needs the word DELETE typed to confirm.

My shortcode shows nothing:

The survey status is Draft or Closed, or it has no questions. Set it to Active and save. Logged in administrators see a short note explaining which it is.

The popup never appears:

Check all four: popup mode is ticked on the survey, the survey is Active, you are on a desktop browser because mobile popups never fire by design, and you have not already seen it in this browser. To test again, clear your site data for the domain or open a private window.

Generate Survey or Read my results says AI is not set up:

Choose a provider, paste your key on the Integrations and AI tab, and click Save AI settings before testing. Then click Test connection on that provider's card, which names the exact provider error.

The AI draft came back empty or thin:

The brief was probably too vague. Name your audience and the decision you are making, not just a topic.

Opt-ins are not reaching my autoresponder:

Start with the route you use.

Your own autoresponder connection: open the Integrations and AI tab. The Your autoresponder card shows how many contacts were sent in the last 7 days, how many are waiting and how many failed, and each failed one lists what the service said, word for word. Check the survey has a list picked (or a routing rule with one; Mailchimp, GetResponse and the full AWeber connection need a list, while Systeme.io and HighLevel work from tags), then use Send a test contact with your own address.

ResultsAiX Mailer: confirm Mailer shows Connected on the Integrations and AI tab and that this survey has a list picked under Where opt-ins go. It is per survey, not global, and an address on your Mailer suppression list is skipped on purpose.

WP Sync: check the WP Sync status at the bottom of the Integrations and AI tab. If it says not installed, install WP Sync. If the license is inactive, activate it. If it says ready, check the bridge: confirm one exists with ResultsAiX Surveys as its source, that the survey matches or the source is All surveys, and that the bridge is enabled.

Nothing is lost while you sort it out, because every opt-in is stored with its response on your site first.

Visitors report that was a little too fast:

That is the bot trap working, because the submission arrived within three seconds of the page loading. A real respondent will never see it.

Need to ask for help?

Open the Diagnostics tab and click Copy Report for Support, then paste it into your ticket. It lists your versions, the AI and autoresponder state, and the health of the plugin's tables, and it never includes passwords or API keys.

License, sites and updates:

Your key activates on the Settings tab, which shows seats in use and your renewal date. Moving to another site means clicking Deactivate license first to free the seat. Updates appear in your normal WordPress Plugins screen while the license is active. If a license lapses, already published surveys keep rendering and keep collecting responses; only the management dashboard locks.

New here? Not a customer yet?See everything ResultsAiX Surveys can do, and get it.Get ResultsAiX Surveys →

Ready to stop reading and start using?

Every plugin documented here works alongside the others, managed from one ResultsAiX Hub.