Formularele de pe site, direct pe telefon

Un formular de contact care doar îți trimite un email e ușor de ratat. Dacă o cerere nouă merită un răspuns în cel mult o oră, merită și o notificare: cine a scris, ce vrea și tot ce a completat.

Merge cu orice formular, pentru că lui Honk îi ajunge o singură cerere HTTPS. Ghidul acoperă cele trei cazuri obișnuite: un plugin de formulare pentru WordPress, un serviciu de formulare găzduit și un formular pe propriul site.

Înainte să începi

• Un cont Honk. Deocamdată, Honk e disponibil doar pe bază de invitație: cere acces.
• Un proiect pentru site, cu o cheie API: în aplicația web, deschide proiectul, apoi Chei.

În toate exemplele de cod de mai jos, fiecare formular trimis are grupul lui. Două persoane care scriu în același timp înseamnă două notificări, nu un grup cu un contor, iar o reîncercare nu trimite niciodată același formular de două ori.

WordPress: pluginul Honk Me

Pluginul Honk Me pentru WordPress recunoaște automat Contact Form 7, WPForms, Gravity Forms, Elementor Pro Forms, Fluent Forms și Ninja Forms. Fiecare formular trimis vine cu numele formularului ca titlu, iar fiecare formular are grupul lui în Honk. Instalează și conectează pluginul cum arată ghidul WooCommerce; merge și fără WooCommerce.

La Setări ▸ Honk ▸ Evenimente ▸ Formulare, apasă Detalii sub pluginul tău de formulare ca să alegi dacă notificările includ ce au completat vizitatorii. La Contact Form 7, WPForms și Gravity Forms poți scoate și câmpuri anume, formular cu formular. Răspunsurile vizitatorilor sunt date personale, așa că se trimit doar cât timp opțiunea Include numele și adresele de email ale clienților e activată.

Fără plugin

Pluginul e în curs de verificare pentru directorul de module WordPress. Până apare acolo, sau dacă preferi să nu-l instalezi, ajung câteva linii într-un plugin must-use. Mai întâi pune cheia în wp-config.php și creează wp-content/mu-plugins/honk.php cu helperul honk_send(), ca în ghidul WooCommerce. Apoi adaugă hookul pentru pluginul tău de formulare.

Pentru Contact Form 7, după ce a plecat emailul formularului:

// Contact Form 7: every sent form becomes a push with all of its fields.
add_action('wpcf7_mail_sent', function ($form) {
    $submission = WPCF7_Submission::get_instance();
    if (!$submission) {
        return;
    }
    $lines = [];
    foreach ($submission->get_posted_data() as $field => $value) {
        $lines[] = $field . ': ' . (is_array($value) ? implode(', ', $value) : $value);
    }
    $id = $form->id() . '-' . $submission->get_meta('timestamp');
    honk_send([
        'title' => 'New message: ' . $form->title(),
        'message' => implode("\n", $lines),
        'severity' => 'light',
        'priority' => 'high',
        'category' => 'customers',
        'source' => 'contact-form-7',
        'group_key' => 'forms/' . $id, // one group per submission
    ], 'cf7-' . $id);
});

Pentru WPForms, după ce înregistrarea a fost salvată:

// WPForms: the same, after the entry is saved.
add_action('wpforms_process_complete', function ($fields, $entry, $form_data, $entry_id) {
    $lines = [];
    foreach ($fields as $field) {
        if ($field['value'] !== '') {
            $lines[] = $field['name'] . ': ' . $field['value'];
        }
    }
    honk_send([
        'title' => 'New entry: ' . $form_data['settings']['form_title'],
        'message' => implode("\n", $lines),
        'severity' => 'light',
        'priority' => 'high',
        'category' => 'customers',
        'source' => 'wpforms',
        'group_key' => 'forms/wpforms-' . $form_data['id'] . '-' . $entry_id,
    ], 'wpforms-' . $form_data['id'] . '-' . $entry_id);
}, 10, 4);

În notificare, titlul e numele formularului, iar mesajul conține toate câmpurile. Pe iPhone-urile cu Apple Intelligence, Honk scoate în evidență și detaliile importante ale cererii, cum ar fi bugetul și termenul, și poate schița un răspuns pe care să-l copiezi. Totul se întâmplă pe dispozitiv.

Formulare găzduite: Make, Zapier sau n8n

Serviciile de formulare găzduite trimit webhookuri în formatul lor, pe care Honk nu îl poate citi ca atare. Folosește ca intermediar un instrument de automatizare care primește formularul și îi trimite lui Honk câmpurile care te interesează.

În Make, ultimul modul este HTTP ▸ Make a request:

Make scenario
  1. Your form tool ▸ Watch responses (or Webhooks ▸ Custom webhook)
  2. HTTP ▸ Make a request
       URL:           https://honk-me.app/v1/messages
       Method:        POST
       Headers:       Authorization = Bearer honk_…
       Body type:     Raw
       Content type:  JSON (application/json)
       Request content:
         {
           "title": "New form entry: {{1.form_name}}",
           "message": "{{1.name}} <{{1.email}}>: {{1.message}}",
           "severity": "light",
           "priority": "high",
           "category": "customers",
           "group_key": "forms/{{1.id}}"
         }

În Zapier merge la fel cu Webhooks by Zapier ▸ POST (Payload Type json, aceleași câmpuri și headerul Authorization), iar în n8n cu nodul Honk. Unde se poate, păstrează cheia în credențialele sau în setările de conexiune ale instrumentului, nu într-un câmp de text obișnuit.

Propriul tău site

Dacă site-ul are un backend, trimite cererea de acolo, după ce ai salvat formularul. Ghidul pentru cererile clienților face asta în Laravel, iar fiecare bibliotecă are aceeași rețetă pentru Node.js, Go, Swift, Kotlin, Java și Rust. Nu apela niciodată Honk din browser: oricine ar putea citi cheia în pagină.

Fără zgomot

• Un grup pentru fiecare formular trimis în exemplele de cod, ca fiecare cerere să te anunțe. Pluginul păstrează în schimb un grup pentru fiecare formular. Dacă formularul începe să primească spam, adaugă-i un câmp honeypot sau un CAPTCHA.
• Prioritatea Ridicată face ca orice cerere să te anunțe, chiar dacă ai mutat pragul pentru notificări la Ridicată ca să nu te deranjeze evenimentele de rutină.
• Orele de liniște țin cererile peste noapte și îți dau un singur rezumat dimineața, dacă nu alegi altfel.
• Datele personale: trimite doar ce îți trebuie ca să răspunzi. Mesajele se păstrează 3, 14 sau 30 de zile, în funcție de plan.