Après un premier import de Zendesk Sell, une commerciale retrouve son opportunité, mais la tâche de relance est attachée à une autre fiche et le montant a perdu ses centimes. Le risque est de reprendre les ventes avec un dossier incomplet malgré un rapport d’import au vert. En pratique, chaque dossier doit pouvoir être rapproché de son état dans Sell avant la bascule.
Zendesk annonce le retrait de Sell le 31 août 2027. La date de fin de votre abonnement peut avancer la perte d’accès aux données. Vérifiez-la avec l’administrateur du compte avant de fixer la recette. Annonce du retrait de Zendesk Sell.
Voici comment décider ce que le CSV suffit à conserver, utiliser Symfony pour compléter ou contrôler l’inventaire et vérifier la migration sur des dossiers commerciaux. Si le changement implique aussi votre ERP ou vos formulaires, notre accompagnement en intégration API CRM aide à préparer la reprise des échanges.
Pour qui préparer un export complémentaire
Une équipe qui reprend ses sociétés, ses contacts et un pipeline simple peut commencer avec les CSV. Ouvrez les fichiers et suivez une opportunité réelle jusqu’à sa société, son propriétaire et sa prochaine tâche. Vérifiez ensuite que le CRM cible sait importer ces relations ou qu’il fournit une table de correspondance après l’import.
Un lecteur Symfony se justifie lorsqu’une relation importante manque au fichier, lorsqu’il faut contrôler un sous-ensemble d’opportunités par API ou lorsque des données arrivent encore entre la première extraction et la bascule. Si l’interface couvre les objets et les champs utiles, alors concentrez le travail technique sur la recette et les autres systèmes à reconnecter.
Choisissez d’abord des dossiers qui demandent un arbitrage. Prenons trois exemples fictifs. Le dossier 4201 a une opportunité ouverte de 1 000,50 EUR et une tâche à échéance proche. Le dossier 4202 a une société mère à conserver. Le dossier 4203 est une vente close liée à un ancien commercial. Utilisez les trois pour vérifier les montants, les associations et le traitement des utilisateurs sortis.
Inventorier les CSV et leurs limites
Le menu d’export de Sell permet à un utilisateur autorisé de récupérer notamment les leads, les contacts, les opportunités, les notes et les tâches. Les fichiers restent disponibles dans l’interface pendant 30 jours selon Zendesk. Consignez pour chaque extraction sa date, son périmètre, l’identité de la personne autorisée à la retrouver et les catégories réellement présentes. Procédure d’export Zendesk Sell.
Vérifiez la hiérarchie de sociétés sur un dossier connu. Zendesk indique que certains champs système, dont l’identifiant de la société mère, sont disponibles par export de liste intelligente. Contrôlez aussi l’historique utile aux commerciaux. L’export standard exclut des catégories telles que les e-mails et les documents. Relevez les besoins réels et vérifiez les options accessibles sur votre compte avant de promettre une reprise. Périmètre annoncé par Zendesk.
Conserver une preuve de l’extraction
Stockez les fichiers d’entrée et le résultat du contrôle dans un espace d’accès restreint. Enregistrez pour chaque lot le nombre de lignes, l’empreinte des fichiers, la date et les filtres. Dans l’exemple 4202, le dossier de recette doit montrer la ligne de la société fille, sa clé parent et la société correspondante dans la liste intelligente. Une personne peut ainsi expliquer le lien après la fermeture du compte.
Gardez les originaux et préparez des copies de travail. Définissez la lecture des identifiants en texte dans l’outil de transformation et documentez le format des dates avant tout import. Un CSV ouvert puis réenregistré dans un tableur peut changer des valeurs. Comparez les clés et les montants transformés aux données source avant d’autoriser le lot.
Vérifier la visibilité des données
Demandez au référent Sell de choisir une opportunité visible uniquement par une équipe restreinte et une autre dont le propriétaire a quitté l’entreprise. Retrouvez les deux avec le compte autorisé qui prépare la migration. Si la visibilité diverge, alors comparez les permissions et le périmètre avant de mesurer la couverture. Un compte dédié peut avoir accès aux dossiers de son équipe et produire une extraction partielle sans erreur HTTP.
Pour chaque fichier, comptez les identifiants uniques à côté du nombre de lignes. Une exportation détaillée peut répéter la même opportunité pour plusieurs relations. Regroupez les lignes par clé avant de comparer les comptes. Dans le dossier 4202, une société avec deux contacts doit conserver ses deux relations dans la cible, même si elle apparaît une seule fois dans le fichier des sociétés.
Lire une page de l’API Sell avec Symfony
Pour un contrôle REST, la Core API Sell utilise api.getbase.com. Configurez un client Symfony dédié avec un jeton OAuth doté des accès de lecture utiles et un User-Agent explicite. La collection des opportunités utilise GET /v2/deals. Suivez ensuite meta.links.next_page quand l’API le fournit. Le count décrit le résultat de la page. Format des réponses et de la pagination Sell.
Le code ci-dessous valide l’origine et le chemin de la page, puis contrôle l’enveloppe JSON. Le service qui pilote l’extraction doit encore valider chaque objet. Injectez un client avec les en-têtes d’accès configurés côté serveur, des délais adaptés et aucune relance automatique. Les URL d’extraction et leurs paramètres restent dans les traces techniques à accès limité.
use Symfony\Contracts\HttpClient\HttpClientInterface;
function sellDealsUrl(string $url): string
{
$parts = parse_url($url);
if (
!is_array($parts)
|| !filter_var($url, FILTER_VALIDATE_URL)
|| ($parts['scheme'] ?? '') !== 'https'
|| ($parts['host'] ?? '') !== 'api.getbase.com'
|| ($parts['port'] ?? 443) !== 443
|| array_key_exists('user', $parts)
|| array_key_exists('pass', $parts)
|| array_key_exists('fragment', $parts)
|| !in_array(
$parts['path'] ?? '',
['/v2/deals', '/v2/deals.json'],
true
)
) {
throw new UnexpectedValueException('URL Sell invalide');
}
return $url;
}
function readSellDealsPage(
HttpClientInterface $client,
string $url = 'https://api.getbase.com/v2/deals'
): array {
$response = $client->request('GET', sellDealsUrl($url), [
'headers' => [
'Accept' => 'application/json',
'User-Agent' => 'MigrationSell/1.0',
],
'max_redirects' => 0,
'timeout' => 5,
'max_duration' => 15,
]);
if ($response->getStatusCode() !== 200) {
throw new RuntimeException(
'Lecture Sell interrompue',
$response->getStatusCode()
);
}
$page = $response->toArray();
$items = $page['items'] ?? null;
$meta = $page['meta'] ?? null;
$links = is_array($meta) ? ($meta['links'] ?? null) : null;
if (
!is_array($items)
|| !array_is_list($items)
|| ($meta['type'] ?? null) !== 'collection'
|| !is_array($links)
) {
throw new UnexpectedValueException('Collection Sell invalide');
}
$next = $links['next_page'] ?? null;
if ($next !== null) {
if (!is_string($next)) {
throw new UnexpectedValueException('Suite Sell invalide');
}
$next = sellDealsUrl($next);
}
return ['items' => $items, 'next' => $next];
}
Reprendre à la dernière page enregistrée
Validez la sortie de la lecture, puis persistez dans une même transaction les lignes admises et l’URL suivante. Si la validation d’un objet échoue, consignez son identifiant et la règle en cause avant de décider si la page peut avancer. Une erreur de stockage doit laisser la même URL à traiter dans le journal. À la relance, une contrainte unique sur le compte Sell, la ressource et l’identifiant évite de compter deux fois un objet déjà traité.
Ajoutez une limite de pages et arrêtez la collecte si une URL déjà traitée réapparaît. La pagination par numéro peut se décaler quand les commerciaux créent ou modifient des objets pendant le passage. En réalité, un parcours arrivé au bout peut avoir manqué une ligne. Comparez les identifiants du périmètre à ceux du CSV et planifiez une dernière extraction avec une fenêtre d’écriture maîtrisée. Paramètres de pagination de la Core API.
Dans la file Symfony, le message d’entrée porte la référence du lot et l’URL attendue. Le contrat de sortie indique la page enregistrée et l’état du traitement. Gardez ces deux valeurs dans la journalisation, avec le nombre de lignes relues et le nombre de nouvelles clés. Si deux workers reçoivent le même message, alors seul celui qui traite l’URL encore attendue peut faire avancer le lot. L’autre relit l’état courant et termine son travail.
Rapprocher contacts, opportunités et tâches
Dans Sell, une collection de contacts peut contenir des personnes et des sociétés. Le champ is_organization distingue les deux. Conservez la clé de chaque objet et le lien de société dans la table de correspondance. Une adresse électronique peut aider un opérateur à examiner une ambiguïté, par exemple lorsqu’un contact a été recréé, mais l’adresse seule autorise mal une fusion automatique. Schéma des contacts Sell.
Pour l’opportunité 4201, le montant exact et la devise doivent rester associés. L’API Sell peut retourner 1000 comme entier et "1000.50" comme chaîne pour une valeur décimale. Normalisez le montant en décimal exact avec sa devise. Contrôlez ensuite l’étape et le contact principal dans le CRM cible. Ajoutez une vérification des contacts secondaires si l’équipe les utilise pour la vente. Schéma des opportunités Sell.
Une tâche liée utilise un type de ressource et un identifiant. Utilisez la paire pour retrouver sa cible. Une tâche peut aussi être indépendante. Relevez la différence lors de l’import et comparez le statut de clôture, l’échéance et le responsable. Si le CRM cible déclenche des rappels à la création, désactivez ce flux pendant la recette ou isolez l’import dans son environnement de test. Schéma des tâches Sell.
Traiter les étapes et propriétaires qui changent
Avant le lot témoin, associez chaque étape Sell utilisée à une étape cible avec son sens métier. Par exemple, la colonne « devis envoyé » peut correspondre à un état distinct dans le nouveau CRM et à un document dans l’ERP. Reprenez la preuve du document lorsqu’elle existe et vérifiez l’effet du changement d’étape sur les automatisations. Les opportunités gagnées du dossier 4203 doivent conserver leur état historique sans déclencher un nouveau devis.
Établissez une table équivalente pour les utilisateurs. Gardez l’identité historique dans les données de migration et désignez un nouveau propriétaire seulement pour les actions qui l’exigent. Pour une tâche ouverte dont le responsable a quitté l’équipe, faites confirmer l’attribution par la vente avant de réactiver son rappel. Cette décision doit rester lisible à partir de la clé de tâche Sell et de la fiche cible.
Erreurs fréquentes avant l’import
Associez chaque erreur à une décision et à la référence que l’opérateur doit consulter. Une réponse d’accès, une page mal formée et une tâche orpheline demandent trois traitements différents. Gardez la dernière étape confirmée et la version du mapping dans le journal.
| Signal | Contrôle | Décision |
|---|---|---|
| Lecture Sell refusée | Jeton, droits et compte source | Corriger l’accès puis reprendre la page. |
| Quota temporaire | Réponse 429 et fenêtre de reprise | Différer la lecture avec un backoff borné. |
| Tâche sans cible valide | Type de ressource et clé source | Faire arbitrer le dossier avant import. |
| Écriture cible incertaine | Référence externe et état relu | Rapprocher la tentative avant de relancer. |
Pour une lecture temporairement indisponible, la file de retry doit garder la même URL et une durée compatible avec la fenêtre d’export. Si la limite de l’API interrompt le traitement, alors reportez la lecture et conservez l’état déjà prouvé. Si un jeton a perdu ses droits, la prochaine action revient à l’administrateur. Limites de l’API Sell.
Lors d’un incident d’écriture, distinguez le rejet explicite d’un résultat inconnu. Pour la création d’une tâche, la dépendance est son opportunité cible. Le contrat prévoit une recherche par référence source ou une autre preuve de création, et la journalisation conserve la dernière réponse de la cible. Si le nouvel outil ne fournit aucun moyen fiable de rapprocher une réponse perdue, confiez le dossier au référent avant toute autre tentative.
Vérifier la bascule et les écritures
Importez d’abord les sociétés et les contacts retenus, puis les opportunités et les tâches qui dépendent de leurs clés. Les tâches indépendantes suivent une règle séparée. Figez pour chaque opération le compte source, l’identifiant Sell, le type d’objet et la cible. Une table des effets confirmés donne une clé d’idempotence à l’import et protège contre les créations concurrentes.
Après le premier import, sélectionnez des dossiers qui couvrent une devise décimale, une société mère, un ancien propriétaire et une tâche close. Comparez les valeurs, les associations et la capacité à retrouver le dossier depuis l’ERP ou les formulaires. Une ancienne attribution commerciale peut être archivée avec son identité d’origine et confiée à un référent actif selon la règle validée par la vente.
Préparer la dernière synchronisation
Inventoriez chaque producteur qui écrit encore dans Sell, y compris un formulaire oublié ou une synchronisation nocturne. Notez son contact technique et le moment où il cesse d’émettre. Rejouez en recette le dernier export puis ouvrez les écritures du nouveau CRM dans un ordre convenu. Les échanges déjà reçus pendant la coupure restent identifiables dans une file ou dans un journal séparé.
Si la validation de la dernière fenêtre révèle des écarts, maintenez la cible fermée aux automatisations concernées et retrouvez les écritures qui ont déjà abouti. En revanche, une reprise des opérations manuelles peut rester possible sur les dossiers vérifiés si l’équipe connaît les règles du gel. Testez cette décision avant le jour de bascule, lorsque les deux systèmes restent disponibles.
Reconstituez les dossiers modifiés pendant cette fenêtre à partir du dernier export et des traces des producteurs. Pour un lead saisi dans un formulaire après le gel de Sell, vérifiez le reçu durable du formulaire, sa présence dans la file et son rattachement après ouverture du CRM cible. Si le même formulaire a renvoyé la demande, le journal doit permettre d’identifier l’unique création confirmée.
Les ressources utiles selon le flux
Le socle des SDK CRM sous Symfony détaille la séparation entre transport, validation et reprise. Pour la migration, réutilisez le suivi des tentatives et gardez la pagination, les types de clés et le contrat de données propres à Sell.
Si Pipedrive est votre cible, le SDK Pipedrive sous Symfony permet de vérifier une opportunité déjà importée à partir de son identifiant cible. Lorsque le changement touche aussi les demandes entrantes du service client, la documentation de l’intégration Zendesk Support aide à inventorier les tickets et les données à afficher côté agent.
Plan d’action avant la fin d’accès à Sell
- D’abord, inventoriez les accès et les données. Notez la date de fin d’abonnement, les listes intelligentes et les objets absents de l’export standard.
- Ensuite, préparez un import témoin. Relisez en priorité les opportunités ouvertes, leurs sociétés, leurs montants et leurs prochaines tâches.
- Puis, simulez l’interruption. Faites échouer une page et perdez une réponse d’écriture pour vérifier la reprise depuis les preuves enregistrées.
- Enfin, validez la sortie. Faites confirmer le rapprochement des dossiers et le nouveau circuit des écritures par les référents vente et intégration.
Choisissez un seuil d’acceptation pour chaque catégorie selon l’impact métier. Une note d’archive manquante peut être enregistrée dans la liste des écarts acceptés. Pour un montant d’opportunité active différent ou une tâche critique mal associée, bloquez le lot concerné jusqu’à correction. Le procès-verbal doit permettre de retrouver ces deux décisions séparément.
Vérifiez aussi qui peut encore restituer les sources après la coupure. Le dossier de réception doit préciser où consulter les CSV, comment relire une clé Sell et qui décide de la durée de conservation. Limitez cette archive aux données nécessaires à la reprise et aux obligations propres à l’entreprise. Les droits de consultation doivent rester distincts de ceux qui permettent de relancer un import.
Après l’ouverture, comparez les nouvelles entrées du CRM cible avec les journaux des formulaires et de l’ERP. Repérez les émetteurs qui continuent d’envoyer vers Sell et réorientez-les un par un. Une fois chaque flux vérifié, retirez son accès Sell et gardez la référence du contrôle pour le support.
Conclusion — livrer un dossier exploitable
La migration est prête quand un commercial retrouve ses opportunités, les bonnes associations et ses actions à venir. Demandez-lui de suivre un dossier d’essai depuis son export Sell jusqu’à la fiche cible et de signaler les valeurs ou les relations dont il se sert pour travailler.
Archivez l’inventaire source, la version du mapping et les décisions sur les écarts. Réservez un délai avant la fin d’accès pour relire une dernière fois les dossiers encore actifs et traiter les exceptions qui demandent l’intervention d’un administrateur.
Si votre nouveau CRM doit reprendre les formulaires, les échanges ERP ou les automatisations qui dépendaient de Sell, nous pouvons vous aider à cadrer l’intégration API CRM, le lot témoin et la vérification de la bascule.