Un négociant répond aux demandes en trois endroits : la boîte de la marketplace, son logiciel de messagerie et le site. Trois interfaces signifient trois qualités de réponse, trois délais et la situation récurrente de deux collègues répondant différemment à la même demande.
Un canal est la liaison vers une source unique et porte son propre profil et ses propres accès. La séparation est essentielle : les accès sont révocables sans supprimer le canal — l’historique reste, l’accès cesse.
| Surface | Rôles |
|---|---|
| Agent commercial | Commerce de pièces, Plateforme et marketplace, Commerce automobile |
Ce que ce cas suppose
- Un profil par canal. Marketplace et messagerie peuvent répondre différemment ; le profil décide du ton et des permissions.
- Une boîte dédiée à l’agent. Une boîte partagée conduit l’agent et l’humain à se retirer mutuellement des messages.
- Un compte marketplace dont le titulaire peut consentir. C’est le titulaire du compte lui-même qui consent, pas nous — cela ne se remplace pas.
- Une surveillance de l’état du canal. Un canal dont la boîte refuse depuis trois jours ne se remarque que si quelqu’un regarde.
Le déroulement
Le tableau indique pour chaque étape l’appel compétent et ce qui existe ensuite. La justification de l’étape figure en dessous.
| Étape | Appel | Ce qui existe ensuite |
|---|---|---|
| Créer le canal | POST /agent/channels | type, name, profileId et settings — imap et smtp relèvent du canal messagerie |
| Obtenir le consentement | POST /agent/channels/{channelId}/ebay/consent | Une authorizeUrl ; c’est le titulaire du compte qui consent, pas nous |
| Déposer les accès messagerie | PUT /agent/channels/{channelId}/mail/credentials | imapStored et smtpStored confirment le dépôt ; le mot de passe ne revient pas |
| Tester la messagerie | POST /agent/channels/{channelId}/mail/test | Un essai sur imap et smtp avant qu’un client n’attende une réponse |
| Surveiller l’état | GET /agent/channels/{channelId}/status | nextPollAt, errorCount, lastErrorCode, pendingEvents et pendingOutbound |
Pourquoi chaque étape est nécessaire
- Créer le canal.
POST /agent/channelsexigetype,nameetprofileIdet prendsettings. Pour une messagerie, cela inclutimapetsmtp— hôte, port et identifiant, mais pas de mot de passe. C’est voulu : les secrets suivent leur propre voie. - Obtenir le consentement de la marketplace.
POST /agent/channels/{channelId}/ebay/consentrenvoie uneauthorizeUrl. Le titulaire consent là-bas, et le retour passe par le chemin prévu. Les accès marketplace ne sont jamais saisis. - Déposer les secrets de messagerie.
PUT /agent/channels/{channelId}/mail/credentialsaccepte les mots de passe et répond parimapStoredetsmtpStored. Aucun mot de passe ne revient : selon le contrat, les mots de passe vont directement dans le coffre chiffré, ne sont jamais journalisés et ne font jamais partie des réglages du canal. - Tester la messagerie.
POST /agent/channels/{channelId}/mail/testse connecte en lecture, sélectionne le dossier et, pour l’envoi, va jusqu’à la connexion ; rien n’est envoyé. Cette étape précède l’exploitation, elle ne la suit pas : sinon un mot de passe erroné n’apparaît qu’avec un client en attente. - Surveiller l’état.
GET /agent/channels/{channelId}/statusrenvoienextPollAt,errorCount,lastErrorCode,pendingEventsetpendingOutbound. C’est là que se branche la supervision — sur des chiffres, non des suppositions.
curl -X POST \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"returnUrl":"https://example.de/agent/einwilligung-fertig"}' \
'https://api.tapinomahub.com/hub/index.php/agent/channels/<channelId>/ebay/consent'Ce que l’on obtient
Au final, marketplace, messagerie et site répondent avec la même qualité, et chaque canal peut être arrêté, testé ou révoqué séparément sans toucher aux autres.
Où cela figure dans la documentation
Les listes de champs contractuelles, les codes d’erreur et les réponses d’exemple se trouvent dans le contrat OpenAPI de cette surface, à l’adresse docs.tapinomahub.com (tapinoma-agent). Tous les cas d’usage classés par surface et par rôle : aperçu des cas d’usage.
Sources et références juridiques
Questions fréquentes
Puis-je utiliser la boîte que mon équipe utilise déjà ?
Techniquement oui, en pratique mieux vaut éviter. Agent et humain se retireraient des messages. Une boîte dédiée garde la responsabilité claire.
Puis-je revoir les mots de passe déposés ?
Non. La réponse confirme seulement le dépôt. Si un mot de passe change, on le redépose ; il est révocable indépendamment du canal.
Que faire si le canal compte des erreurs ?
Lire l’état d’exploitation. lastErrorCode indique le dernier code d’erreur, errorCount compte les erreurs — et le test de messagerie peut être relancé ciblé.