{"id":198,"date":"2026-10-31T11:03:27","date_gmt":"2026-10-31T05:03:27","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/?post_type=nirohelp_doc&p=198"},"modified":"2026-10-31T11:03:28","modified_gmt":"2026-10-31T05:03:28","slug":"contact-form-7","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/integrations\/contact-form-7\/","title":{"rendered":"Contact Form 7"},"content":{"rendered":"\n

Turn submissions of your Contact Form 7 forms into NiroHelp tickets. A site usually has several forms and only some of them are for support, so each one is added on its own, with its fields mapped onto the ticket’s. A form you don’t add keeps working exactly as before and never opens a ticket.<\/p>\n\n\n\n

Where the screen is<\/h2>\n\n\n\n

NiroHelp \u2192 Integrations \u2192 Contact Form 7.<\/strong> Like the rest of Integrations, it needs the manage_options<\/code> capability, so only administrators see it. It also needs the tickets module on and Contact Form 7 installed and active; without Contact Form 7 the screen says so and offers nothing to add.<\/p>\n\n\n\n

Adding a form<\/h2>\n\n\n\n
    \n
  1. Go to NiroHelp \u2192 Integrations \u2192 Contact Form 7<\/strong>.<\/li>\n\n\n\n
  2. Click Add form<\/strong>. (It is greyed out once every form on the site has been added.)<\/li>\n\n\n\n
  3. Choose the Form<\/strong>.<\/li>\n\n\n\n
  4. Under Field mapping<\/strong>, pick which of the form’s fields fills each part of the ticket:\n
      \n
    • Requester email<\/strong> \u2014 required. The ticket is filed under this address.<\/li>\n\n\n\n
    • Requester name<\/strong>, Subject<\/strong>, Message<\/strong>.<\/li>\n\n\n\n
    • Product<\/strong>, Reason<\/strong>, Urgency<\/strong> \u2014 the submitted value is matched to an existing product, reason or urgency by its name or slug (or its ID), so a dropdown whose options read “Billing” and “Shipping” lands on the reasons with those names.<\/li>\n\n\n\n
    • Order ID<\/strong>, and any custom field switched on in the ticket form under Settings \u2192 Tickets \u2192 Form fields<\/strong>.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • Under Defaults<\/strong>, optionally choose a Default product<\/strong>, Default reason<\/strong> and Default urgency<\/strong>. They apply when no field is mapped for that part, or the submitted value doesn’t match anything.<\/li>\n\n\n\n
    • Click Add form<\/strong>.<\/li>\n<\/ol>\n\n\n\n

      The form is added active. Only the form’s own fields are offered in each picker.<\/p>\n\n\n\n

      What a ticket gets<\/h2>\n\n\n\n
        \n
      • Subject<\/strong> \u2014 the mapped field, or “New message from form title<\/em>” when none is mapped or it was left empty.<\/li>\n\n\n\n
      • Message<\/strong> \u2014 the mapped message, then every other field the form submitted that isn’t mapped, as a list of field: value<\/em> lines. Nothing the visitor typed is lost to the mapping. Fields that aren’t part of the form are ignored, whatever else arrives with the request.<\/li>\n\n\n\n
      • Attachments<\/strong> \u2014 files uploaded through a file field are attached to the ticket. NiroHelp’s own allowed file types and size limit apply, not the form’s. A file NiroHelp refuses is listed in a private note on the ticket with the reason.<\/li>\n\n\n\n
      • Source<\/strong> \u2014 the ticket is marked as coming from Contact Form 7 (_nirohelp_source = cf7<\/code>), and the form it came from is kept on it (_nirohelp_cf7_form_id<\/code>).<\/li>\n<\/ul>\n\n\n\n

        The ticket then goes through everything a ticket from the web form does: agent assignment, the customer’s notification and sign-in link, the AI auto responder, Slack and webhooks.<\/p>\n\n\n\n

        A ticket is created whether or not Contact Form 7 manages to send its own notification email. Submissions Contact Form 7 marks as spam, or that fail its validation, never reach NiroHelp.<\/p>\n\n\n\n

        Who can open a ticket this way<\/h2>\n\n\n\n

        The same rules as a ticket by email. The ticket always goes to the address in the mapped email field \u2014 being signed in to your site makes no difference, because Contact Form 7 sends its submissions without the visitor’s sign-in.<\/p>\n\n\n\n

          \n
        • Somebody whose email already has an account<\/strong> gets the ticket on that account, and a sign-in link to it by email.<\/li>\n\n\n\n
        • Somebody with no account<\/strong> only gets a ticket when both Allow guest submissions<\/strong> and Create accounts for new clients<\/strong> (or WordPress’s own Anyone can register<\/em>) are on, under Settings \u2192 Tickets \u2192 Submission<\/strong>. Otherwise Contact Form 7 handles the submission as usual, but no ticket is opened. While that applies, the Contact Form 7 screen says which setting is off.<\/li>\n<\/ul>\n\n\n\n

          Managing a form<\/h2>\n\n\n\n

          Each added form shows whether it’s Active<\/strong> or Disabled<\/strong>, which field the requester comes from, how many fields are mapped, and how many tickets it has opened.<\/p>\n\n\n\n

            \n
          • Edit<\/strong> \u2014 change the mapping and the defaults. The form keeps its active or disabled state.<\/li>\n\n\n\n
          • Disable<\/strong> \/ Enable<\/strong> \u2014 stop or resume opening tickets, keeping the mapping.<\/li>\n\n\n\n
          • Edit in Contact Form 7<\/strong> \u2014 open the form itself.<\/li>\n\n\n\n
          • Remove<\/strong> \u2014 asks first. The form stops opening tickets and its mapping is deleted. Tickets it already opened stay, and the form itself isn’t changed.<\/li>\n<\/ul>\n\n\n\n

            If you rename or delete a mapped field in Contact Form 7, the form’s row warns that the field no longer exists. Edit the mapping: a form whose requester email field has gone opens no tickets.<\/p>\n\n\n\n

            <\/p>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"nirohelp_product":[],"nirohelp_topic":[19],"class_list":["post-198","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-integrations"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/198","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc"}],"about":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/types\/nirohelp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/media?parent=198"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=198"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=198"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}