Configurer l'intégration Webhook

Objectif

Envoyer automatiquement chaque document généré par POP (XML ou PDF) vers un outil externe : Zapier, Make (Integromat), un CRM, Google Drive, ou un endpoint personnalisé.

Prérequis

• POP plan Basic ou supérieur — l’envoi par webhook n’est pas disponible sur le plan gratuit.
• Un endpoint HTTP à l’écoute (l’URL webhook de destination).

Étapes

1. Sur popapi.io, allez dans Mon compte > Intégrations > POP to Webhook > Connecter.
2. Configurez :
   • un nom identifiant
   • l’URL webhook de destination
   • le format des données : JSON ou XML
   • l’interrupteur d’activation
3. Sur WordPress : dans le plugin POP, allez dans Avancé > Webhook, saisissez l’ID du webhook créé à l’étape précédente, activez-le, et — si vous voulez un envoi en arrière-plan plutôt que synchrone — activez aussi l’envoi automatique via CRON.
4. Sur Shopify : saisissez l’ID du webhook dans les paramètres de l’app ; une icône apparaîtra dans la liste des factures pour envoyer les données.

Formats

• JSON — conçu pour les plateformes no-code (Zapier, Make) : les données sont automatiquement aplaties dans une structure facile à mapper.
• XML — adapté à l’archivage ou aux systèmes exigeant le standard FatturaPA ; peut aussi être envoyé en pièce jointe.

Vous pouvez configurer plusieurs webhooks avec des URL et formats différents en même temps.

Erreurs courantes

• URL de webhook invalide — vérifiez que l’URL est accessible publiquement et répond avec succès (il ne suffit pas qu’elle soit syntaxiquement correcte).
• Format de données non pris en charge — utilisez uniquement JSON ou XML ; les autres formats sont rejetés.
• Le webhook ne reçoit rien en sandbox — limitation attendue : l’envoi par webhook n’est pas disponible dans l’environnement sandbox (voir use-sandbox-environment).

Configuration associée

Pour le cas particulier du transfert vers n8n avec un connecteur dédié (ex. Zoho), voir api/connectors et n8n.