Intégration QuickBooks

• Connexion OAuth avec PKCE
• Association de compagnie QuickBooks par identifiant realm
• Synchronisation des clients de QuickBooks vers les contacts demeterrr
• Chemin de déclenchement optionnel par facture payée pour les exécutions de séquences
• Déconnexion et reconnexion depuis les Intégrations

1. Allez dans Paramètres > Intégrations.
2. Cliquez sur Connecter QuickBooks.
3. Complétez l'authentification OAuth dans Intuit.
4. Revenez dans demeterrr et confirmez le statut Connecté.

Lors du rappel, l'intégration enregistre votre realmId QuickBooks.

Utilisez Synchroniser maintenant dans la carte QuickBooks pour déclencher l'importation de clients à la demande.

Le point de terminaison de synchronisation supporte actuellement les opérations d'importation de type contact (syncType: contacts).

Lorsqu'il est activé dans la configuration de l'intégration, les événements webhook QuickBooks Payment Create peuvent déclencher des exécutions de séquences.

Valeurs de configuration requises :

• triggerOnInvoicePaid: true
• triggerDelayDays (optionnel, 0-90 ; mettez > 0 si le service est livré après le paiement)
• sequenceId configuré vers une séquence active

Ces options sont disponibles via la route API de configuration QuickBooks.

Après la connexion de QuickBooks et la sauvegarde des paramètres de déclenchement par facture payée, votre équipe n'a pas besoin d'ouvrir demeterrr pour exécuter ce flux.

L'automatisation s'exécute côté serveur :

1. Le client paie une facture dans QuickBooks.
2. QuickBooks envoie un événement webhook signé.
3. demeterrr vérifie la signature du webhook.
4. demeterrr crée et envoie l'exécution de séquence configurée.

Les requêtes webhook de QuickBooks sont validées par vérification de signature HMAC avec :

• QUICKBOOKS_WEBHOOK_VERIFIER

Si cette valeur est manquante ou invalide, les événements webhook sont rejetés.

1. Ouvrez Paramètres > Intégrations.
2. Cliquez sur Déconnecter dans la carte QuickBooks.
3. Confirmez l'action.

La déconnexion arrête la synchronisation et l'automatisation par facture payée.

Vérifiez :

• QUICKBOOKS_CLIENT_ID
• QUICKBOOKS_CLIENT_SECRET

Si le rappel échoue avec des erreurs spécifiques à QuickBooks, reconnectez-vous et confirmez que votre URL de rappel correspond au domaine de l'application en cours d'exécution.

Vérifiez :

• QUICKBOOKS_WEBHOOK_VERIFIER est configuré
• Le statut de l'intégration est connecté
• triggerOnInvoicePaid et sequenceId sont configurés si vous attendez une automatisation

• Intégration Salesforce
• Intégration HubSpot
• Créer votre première séquence