Utiliser l'API catalogue dans votre CRM
L'API catalogue Furb permet d'intégrer le stock + prix partenaire en temps réel dans votre CRM (HubSpot, Salesforce) ou ERP. Voici les bases techniques.
Authentification
Obtenez votre clé API dans le portail partenaire (Silver+). En-tête HTTP standard : X-Furb-Api-Key: {votre_clé}. La clé est rotatable, l'invalidation immédiate. Aucun OAuth pour cette version — clé statique, à protéger comme un secret.
Endpoints clés
GET /v1/catalog/availability retourne tout le stock disponible avec prix partenaire. GET /v1/catalog/{sku} donne le détail d'un SKU. POST /v1/quote crée un devis (réservation 24h). POST /v1/deal-registration enregistre un lead protégé 60 jours. GET /v1/orders/{id}/status suit une commande.
Refresh & cache
Le stock change toutes les 15 minutes. Pour éviter de surcharger l'API, mettez en cache 10 min côté CRM. Pour les SKUs critiques (stock faible < 5 unités), utilisez les webhooks pour recevoir les changements en push : POST {votre_webhook} { event: 'stock_low', sku: '...', count: 3 }.
Intégration HubSpot
Côté HubSpot : créez un Custom Object « Furb Product » avec les champs (sku, grade, price_partner, stock). Workflow scheduler 15 min qui fetch /v1/catalog/availability et update le Custom Object. Dashboard commerciaux : Sales hub deals → linked Furb Product → stock visible en direct.
Intégration Salesforce
Côté Salesforce : Named Credential pour stocker la clé, Apex scheduled job (15 min) pour fetch l'API, Custom Object Furb_Product__c. Opportunity Product : sélection à partir de la liste Furb Product. Triggers automatisés sur stock_low.
À retenir
- Auth : header X-Furb-Api-Key. Rotation possible, protéger comme un secret.
- Endpoints : availability, quote, deal-registration, orders.
- Refresh : 15 min côté Furb. Cache 10 min côté CRM. Webhook pour stock faible.
- HubSpot : Custom Object + scheduled workflow.
- Salesforce : Named Credential + Apex scheduled.