Skip to main content
In this chapter
< Contents
Print

EspoCRM troubleshooting

Die Verbindung wird abgelehnt

  • Prüfen Sie die EspoCRM-Basis-URL und deren Erreichbarkeit aus dem mailfino-System.
  • Kopieren Sie den API-Key ohne zusätzliche Leerzeichen.
  • Prüfen Sie, ob der API-Benutzer aktiv ist und die vorgesehene Rolle besitzt.

Contacts, Felder oder Target Lists fehlen

Prüfen Sie die Rolle des API-Benutzers. Der Verbindungstest benötigt Zugriff auf Contacts und Metadaten; Target Lists erscheinen nur mit Leserecht. Nicht beschreibbare oder interne Contact-Felder werden absichtlich nicht als Formularziel angeboten.

Ein Formularereignis benötigt Prüfung

Typische Ursachen sind eine fehlende E-Mail-Adresse, mehrere Contacts mit derselben E-Mail-Adresse, ein nicht mehr vorhandenes Zielfeld oder fehlende Schreibrechte. Bereinigen Sie Dubletten oder passen Sie Rolle und Feldzuordnung an.

Ein Reimport erzeugt unerwartete Ergebnisse

mailfino verwendet die EspoCRM Contact-ID als Remote-Key. Ein gelöschter und neu angelegter Contact besitzt eine neue ID. Prüfen Sie außerdem, ob die gewählte Target List noch dieselben Beziehungen enthält.

Touchpoints erscheinen nicht

Prüfen Sie, ob Touchpoints aktiviert sind, der lokale Kontakt aus EspoCRM importiert wurde und der API-Benutzer Stream-Beiträge am Contact anlegen darf.

Webhooks

EspoCRM kann signierte Webhooks bereitstellen. Der Webhook-Empfang ist in dieser mailfino-Beta noch nicht aktiviert; Änderungen werden durch Import oder Reimport übernommen.

The connection is rejected

  • Check the EspoCRM base URL and whether mailfino can reach it.
  • Copy the API key without leading or trailing spaces.
  • Confirm that the API User is active and has the intended Role.

Contacts, fields, or Target Lists are missing

Review the API User’s Role. Validation needs Contacts and metadata access; Target Lists require read access. Internal or non-writable Contact fields are intentionally excluded from form targets.

A form event requires review

Common causes are a missing email address, multiple Contacts with the same email, a removed target field, or missing write permissions. Resolve duplicates or update the Role and field mapping.

Reimport gives unexpected results

mailfino uses the EspoCRM Contact ID as its remote key. A deleted and recreated Contact receives a new ID. Also check whether the selected Target List still contains the expected relationships.

Touchpoints do not appear

Confirm that touchpoints are enabled, the local contact was imported from EspoCRM, and the API User can create Contact stream posts.

Webhooks

EspoCRM provides signed webhooks, but mailfino’s webhook receiver is not enabled in this beta. Use import or reimport to retrieve changes.