API-Flow
Ein API-Flow ist die automatisierte Versand-Engine von PostPal: Du lieferst Empfänger programmatisch über die API ein, PostPal sammelt sie und bildet in einem wiederkehrenden (wöchentlichen) Trigger-Fenster einen Batch, der als Postkarten-Aussendung verschickt wird. Abgerechnet wird nach der tatsächlich versendeten Batch-Größe. Jeder Flow benötigt ein hinterlegtes Postkarten-Design.
Ein API-Flow ist die automatisierte Versand-Engine von PostPal für programmatisch eingelieferte Empfänger. Statt ein fertiges Segment zu versenden, nimmt ein Flow laufend einzelne Einträge über die PostPal-API entgegen und bündelt sie automatisch zu wiederkehrenden Aussendungen.
So funktioniert ein Flow:
- Du lieferst Empfänger über die API ein; sie werden als Einträge im Flow
gesammelt (Zustände:
pending,batched,skipped,failed). - In einem wöchentlichen Trigger-Fenster bildet PostPal aus den fälligen Einträgen einen Batch und erzeugt daraus eine Postkarten-Aussendung.
- Abgerechnet wird nach der tatsächlichen Batch-Größe.
Ein Flow ist entweder aktiv oder pausiert und benötigt ein hinterlegtes Postkarten-Design. Reicht das Guthaben für einen Batch nicht, bleibt der Flow konfiguriert und die offenen Einträge werden im nächsten Lauf erneut versucht.
Häufige Fragen
- Wie unterscheidet sich ein API-Flow von einer normalen Kampagne?
- Eine Kampagne richtet sich an ein bestehendes Segment. Ein PostPal-API-Flow nimmt laufend einzelne Empfänger über die API entgegen und bündelt sie automatisch zu wiederkehrenden Aussendungen, ideal für ereignisgesteuerte Postkarten.
- Wie wird ein API-Flow abgerechnet?
- PostPal rechnet einen API-Flow nach der tatsächlichen Batch-Größe ab, nicht nach einer Mindestmenge. Die Trigger-Schwelle steuert nur, wann ein wöchentlicher Batch gebildet wird.
- Was passiert, wenn mein Guthaben für einen Batch nicht reicht?
- Der Flow bleibt konfiguriert und pausiert nicht dauerhaft. Die offenen Einträge werden im nächsten wöchentlichen Lauf erneut verarbeitet, und du wirst über das fehlende Guthaben benachrichtigt.
- Brauche ich ein Design für einen API-Flow?
- Ja. Jeder API-Flow benötigt ein hinterlegtes Postkarten-Design, bevor er Aussendungen erzeugen kann.