Documentation: Plugin simple AroksDS Submission Alerts for Contact Form 7 to Telegram

Pourquoi cette extension ?

Dans la pratique, l’e-mail n’est pas 100% prévisible : même lorsque Contact Form 7 affiche « envoyé », le message peut finir dans les spams,
être bloqué par une configuration SMTP/DMARC ou arriver en retard. Résultat: un lead perdu.

Cette extension crée un canal de notification supplémentaire et indépendant dans Telegram, afin que l’équipe commerciale ou support voie les soumissions immédiatement —
sans rafraîchir le tableau de bord et sans risque de les manquer.

Principaux avantages

• Backup de l’e-mail – moins de risques de perdre des leads à cause du spam ou de problèmes de livraison.
• Groupe partagé – un seul endroit où tout le monde voit les nouvelles soumissions.
• Réaction plus rapide (SLA) – notification juste après une soumission réussie.
• Routage clair – différents formulaires → différents chats ou sujets (vente / support / recrutement).
• Contrôle des données – n’envoyez que les champs sélectionnés (Allowed/Excluded) et votre propre modèle.
• Léger et prévisible – pas de CRM lourd ni d’intégrations inutiles.

Fonctionnalités

• Uniquement en cas de succès : déclenchement via wpcf7_mail_sent (pas de “before_send_mail” dans l’édition WordPress.org).
• Réglages globaux + règles par formulaire : ID formulaire → ID chat → (optionnel) ID sujet → modèle → champs.
• Modèles & variables :
  {field-name}, {form_id}, {form_title}, {page_url},
  {date}, {time}, {all_fields}.
• Mise en forme : Plain / HTML / MarkdownV2 (valeurs des variables échappées en toute sécurité).
• Logs (100 derniers) : erreurs toujours ; succès seulement si Debug Logs est activé.
• Test admin : envoi d’un message de test depuis wp-admin.
• Sans télémétrie : aucun tracking, aucun appel externe hors Telegram Bot API.

Ce que l’extension NE fait PAS

• Envoie des messages texte (Telegram sendMessage) – pas de fichiers/pièces jointes.
• Ne remplace pas l’e-mail – ajoute un canal de secours.
• Ce n’est pas un CRM et ne crée pas une base de leads dans WordPress (objectif : notification rapide et fiabilité).

Configuration (pas à pas)

1. Installez et activez Contact Form 7.
2. Installez et activez cette extension.
3. Allez dans : WordPress → Réglages → AroksDS Submission Alerts for Contact Form 7 to Telegram
4. Renseignez le Bot Token et l’ID de chat par défaut.
5. (Optionnel) définissez l’ID de sujet (Message Thread ID) pour les topics Telegram.
6. Configurez le modèle et les champs Allowed/Excluded.
7. Onglet Tools → envoyez un test.

Confidentialité et service externe

L’extension se connecte uniquement à la Telegram Bot API. Données envoyées : chat_id, texte du message (modèle + champs sélectionnés),
éventuellement parse_mode et message_thread_id. Le token du bot n’est jamais enregistré dans les logs.
Vous pouvez limiter les données via Allowed/Excluded et en modifiant le modèle.