Documentatie: Eenvoudige plugin AroksDS Submission Alerts for Contact Form 7 to Telegram

Waarom deze plugin?

E-mail is in de praktijk niet 100% voorspelbaar: zelfs wanneer Contact Form 7 “verzonden” toont, kan het bericht in spam belanden,
worden geblokkeerd door SMTP/DMARC-instellingen of met vertraging aankomen. Resultaat: een verloren lead.

Deze plugin maakt een extra, onafhankelijk meldingskanaal in Telegram, zodat sales- of supportteams inzendingen direct zien —
zonder het dashboard te verversen en zonder risico op missen.

Belangrijkste voordelen

• Back-up naast e-mail – minder kans op leadverlies door spam of afleverproblemen.
• Gezamenlijke groep voor managers – één plek waar iedereen nieuwe inzendingen ziet.
• Snellere reactie (SLA) – melding komt direct na succesvolle verzending.
• Routing zonder chaos – verschillende formulieren → verschillende chats of topics (sales / support / recruitment).
• Datacontrole – verstuur alleen geselecteerde velden (Allowed/Excluded) en je eigen berichttemplate.
• Licht en voorspelbaar – geen zware CRM’s en geen overbodige integraties.

Functies

• Alleen bij succes: trigger via wpcf7_mail_sent (geen “before_send_mail” in de WordPress.org-editie).
• Globale instellingen + regels per formulier: Form ID → Chat ID → (optioneel) Thread ID → template → velden.
• Templates en placeholders:
  {field-name}, {form_id}, {form_title}, {page_url},
  {date}, {time}, {all_fields}.
• Opmaak: Plain / HTML / MarkdownV2 (placeholderwaarden worden veilig ge-escaped).
• Logs (laatste 100): fouten altijd; successen alleen met ingeschakelde Debug Logs.
• Test in admin: stuur een testbericht vanuit wp-admin.
• Geen telemetry: geen tracking en geen externe calls behalve Telegram Bot API.

Wat deze plugin NIET doet (om misverstanden te voorkomen)

• Stuurt tekst (Telegram sendMessage) – geen bestanden/bijlagen.
• Vervangt e-mail niet – voegt een back-upkanaal toe.
• Is geen CRM en bouwt geen lead-database in WordPress (doel: snelle meldingen en betrouwbaarheid).

Configuratie (stap voor stap)

1. Installeer en activeer Contact Form 7.
2. Installeer en activeer deze plugin.
3. Ga naar: WordPress → Instellingen → AroksDS Submission Alerts for Contact Form 7 to Telegram
4. Stel Bot Token en Standaard Chat ID in.
5. (Optioneel) stel Message Thread ID in voor Telegram topics.
6. Stel template en Allowed/Excluded-velden in.
7. Tab Tools → stuur een test.

Privacy en externe dienst

De plugin verbindt uitsluitend met de Telegram Bot API. Verzonden data: chat_id, berichttekst (uit template en gekozen velden),
optioneel parse_mode en message_thread_id. De bot token wordt niet in logs opgeslagen.
Je kunt data beperken via Allowed/Excluded en door het template te bewerken.