openapi: 3.1.0
info:
  title: AMBS Agency - DialAgent API
  description: >
    AMBS Agency est une agence française spécialisée en IA conversationnelle et automatisation marketing.
    DialAgent est la plateforme européenne qui transforme les conversations clients (WhatsApp, SMS, Voix, Webchat)
    en revenus mesurables. 100% hébergée en Europe, nativement conforme au RGPD.
  version: 1.0.0
  contact:
    name: AMBS Agency
    email: contact@ambs-agency.com
    url: https://ambs-agency.com
  license:
    name: Proprietary
    url: https://ambs-agency.com/cgv
  x-logo:
    url: https://ambs-agency.com/logo-ambs.png
    altText: AMBS Agency Logo

servers:
  - url: https://ambs-agency.com
    description: Site principal AMBS Agency

externalDocs:
  description: Documentation complète DialAgent
  url: https://ambs-agency.com/plateforme

tags:
  - name: Informations
    description: Informations publiques sur AMBS Agency et DialAgent
  - name: Solutions
    description: Solutions et cas d'usage DialAgent
  - name: Ressources
    description: Blog, cas clients et ressources
  - name: Industries
    description: Pages dédiées aux secteurs servis par DialAgent
  - name: Roles
    description: Pages dédiées aux fonctions métiers accompagnées
  - name: Legal
    description: Informations légales, politiques et gestion des consentements


paths:
  /:
    get:
      operationId: getHomepage
      summary: Page d'accueil AMBS Agency
      description: >
        Présentation de DialAgent, la plateforme européenne d'IA conversationnelle orientée revenus.
        Agents IA autonomes sur WhatsApp, SMS, Voix, Chat. ROI x6-x12 garanti, déploiement en 2 semaines.
      tags: [Informations]
      responses:
        "200":
          description: Page d'accueil avec présentation produit, FAQ et témoignages

  /demo:
    get:
      operationId: getDemo
      summary: Demander une démonstration
      description: >
        Formulaire de demande de démonstration personnalisée de DialAgent.
        Essai gratuit 14 jours, sans engagement.
      tags: [Informations]
      responses:
        "200":
          description: Formulaire de demande de démo

  /plateforme:
    get:
      operationId: getPlateforme
      summary: Présentation de la plateforme DialAgent
      description: >
        Vue d'ensemble de la plateforme DialAgent : agents IA, orchestration multi-canal,
        revenue intelligence, stack technique et sécurité.
      tags: [Solutions]
      responses:
        "200":
          description: Page plateforme

  /plateforme/ai-agents:
    get:
      operationId: getAIAgents
      summary: Agents IA autonomes
      description: >
        Agents conversationnels IA qui qualifient, convertissent et supportent vos clients 24/7
        sur WhatsApp, SMS, Voix et Webchat.
      tags: [Solutions]
      responses:
        "200":
          description: Page agents IA

  /plateforme/orchestration:
    get:
      operationId: getOrchestration
      summary: Orchestration multi-canal
      description: >
        Orchestrez vos conversations sur tous les canaux depuis une seule plateforme.
        WhatsApp Business API, SMS, RCS, Voix, Email, Instagram DM.
      tags: [Solutions]
      responses:
        "200":
          description: Page orchestration

  /plateforme/revenus-intelligence:
    get:
      operationId: getRevenueIntelligence
      summary: Revenue Intelligence
      description: >
        Tableaux de bord et analytics en temps réel pour mesurer le ROI de chaque conversation.
        Scoring prédictif et attribution multi-touch.
      tags: [Solutions]
      responses:
        "200":
          description: Page revenue intelligence

  /plateforme/securite:
    get:
      operationId: getSecurite
      summary: Sécurité et conformité RGPD
      description: >
        Hébergement 100% européen (France/Allemagne), chiffrement E2E, ISO 27001, SOC 2.
        RGPD natif, DPO dédié, pas de transfert hors UE.
      tags: [Solutions]
      responses:
        "200":
          description: Page sécurité

  /plateforme/stack-technique:
    get:
      operationId: getStackTechnique
      summary: Stack technique DialAgent
      description: >
        Architecture technique détaillée de DialAgent : moteurs IA (GPT-4, Claude), orchestration (n8n, Kafka),
        connecteurs de canaux (WhatsApp, Twilio) et analytics (ClickHouse, Metabase).
      tags: [Solutions]
      responses:
        "200":
          description: Présentation de l'architecture technique et des intégrations natives

  /use-cases:
    get:
      operationId: getUseCases
      summary: Cas d'usage DialAgent
      description: >
        6 cas d'usage principaux : Lead-to-Revenue, Réactivation clients, Maximisation événements,
        Support 24/7, Accélération ventes, Fidélisation et upsell.
      tags: [Solutions]
      responses:
        "200":
          description: Liste des cas d'usage

  /use-cases/{slug}:
    get:
      operationId: getUseCaseDetail
      summary: Détail d'un cas d'usage DialAgent
      description: >
        Page détaillée présentant le workflow, les KPI et le ROI d'un cas d'usage DialAgent
        (qualification leads, réactivation clients, événements, support, ventes, fidélisation).
      tags: [Solutions]
      parameters:
        - name: slug
          in: path
          required: true
          description: Identifiant du cas d'usage présenté.
          schema:
            type: string
            enum:
              - lead-to-revenus
              - customer-reactivation
              - event-revenus-maximizer
              - customer-support-24-7
              - sales-acceleration
              - retention-upsell
      responses:
        "200":
          description: Page détaillée avec workflow, métriques et ROI

  /industries:
    get:
      operationId: getIndustries
      summary: Industries servies
      description: >
        Solutions adaptées par industrie : E-commerce, Immobilier, Automobile, Services B2B.
        Cas clients et métriques spécifiques par secteur.
      tags: [Industries]
      responses:
        "200":
          description: Liste des industries

  /industries/{industry}:
    get:
      operationId: getIndustryDetail
      summary: Solution par industrie
      description: >
        Page secteur détaillant les use cases, enjeux et résultats pour une industrie spécifique
        (immobilier, automobile, services B2B, e-commerce).
      tags: [Industries]
      parameters:
        - name: industry
          in: path
          required: true
          description: Identifiant du secteur visé par la page.
          schema:
            type: string
            enum:
              - immobilier
              - automobile
              - services-b2b
              - e-commerce
      responses:
        "200":
          description: Page secteur avec parcours types, chiffres clés et témoignages

  /cas-clients:
    get:
      operationId: getCasClients
      summary: Études de cas clients
      description: >
        Résultats concrets de nos clients : Groupe 3F (+344% taux de lecture),
        Plateforme RH B2B (x3.2 conversion), Groupe Automobile (+180% inscriptions).
      tags: [Ressources]
      responses:
        "200":
          description: Liste des cas clients

  /cas-clients/{slug}:
    get:
      operationId: getCaseStudyDetail
      summary: Étude de cas détaillée
      description: >
        Page détaillée présentant le contexte, la solution déployée et les résultats pour un client DialAgent
        (immobilier, SaaS B2B, automobile, etc.).
      tags: [Ressources]
      parameters:
        - name: slug
          in: path
          required: true
          description: Identifiant de l'étude de cas.
          schema:
            type: string
            enum:
              - groupe-3f
              - saas-b2b
              - concession-auto
      responses:
        "200":
          description: Étude de cas complète avec métriques, témoignages et enseignements

  /roles:
    get:
      operationId: getRoles
      summary: Solutions par rôle
      description: >
        Présentation des bénéfices DialAgent pour les principales fonctions métiers : marketing, ventes,
        support client et équipes growth.
      tags: [Roles]
      responses:
        "200":
          description: Page présentant la synthèse des rôles accompagnés

  /roles/{role}:
    get:
      operationId: getRoleDetail
      summary: Détail d'un rôle métier accompagné
      description: >
        Page détaillant les enjeux, KPI et parcours recommandés pour un rôle spécifique
        (marketing, commerce & ventes, support & CX, growth).
      tags: [Roles]
      parameters:
        - name: role
          in: path
          required: true
          description: Identifiant du rôle ciblé.
          schema:
            type: string
            enum:
              - marketing
              - commerce-ventes
              - support-cx
              - growth
      responses:
        "200":
          description: Page rôle avec leviers, indicateurs et recommandations

  /blog:
    get:
      operationId: getBlog
      summary: Blog AMBS Agency
      description: >
        Articles sur l'IA conversationnelle, la génération de leads, le support client
        et les bonnes pratiques d'automatisation marketing.
      tags: [Ressources]
      responses:
        "200":
          description: Liste des articles de blog

  /blog/{slug}:
    get:
      operationId: getBlogArticle
      summary: Article de blog détaillé
      description: >
        Article approfondi du blog AMBS Agency couvrant un sujet d'IA conversationnelle,
        de support client ou de génération de leads.
      tags: [Ressources]
      parameters:
        - name: slug
          in: path
          required: true
          description: Identifiant de l'article de blog.
          schema:
            type: string
            enum:
              - generation-leads-ia
              - support-assistance-ia
              - pourquoi-choisir-ambs
              - agents-ia-service-client
      responses:
        "200":
          description: Article complet avec sections, données et ressources associées

  /sources:
    get:
      operationId: getSources
      summary: Sources et références
      description: >
        Liste des études et rapports 2024-2025 qui étayent nos statistiques (gestion des leads,
        qualité des données CRM, fidélisation client, implémentation CRM).
      tags: [Ressources]
      responses:
        "200":
          description: Page de références avec liens externes vérifiés

  /calculateur-roi:
    get:
      operationId: getCalculateurROI
      summary: Calculateur de ROI
      description: >
        Estimez le retour sur investissement de DialAgent pour votre entreprise.
        Simulation personnalisée basée sur votre secteur et vos volumes.
      tags: [Ressources]
      responses:
        "200":
          description: Calculateur ROI interactif

  /a-propos:
    get:
      operationId: getAPropos
      summary: À propos d'AMBS Agency
      description: >
        AMBS Agency, agence française fondée en 2020. +200 projets livrés,
        +50M€ de revenus générés pour nos clients. Basée à Paris.
      tags: [Informations]
      responses:
        "200":
          description: Page à propos

  /mentions-legales:
    get:
      operationId: getMentionsLegales
      summary: Mentions légales
      description: >
        Informations légales sur AMBS Agency : éditeur, hébergeur, propriété intellectuelle,
        responsabilité, conditions d'utilisation.
      tags: [Legal]
      responses:
        "200":
          description: Page de mentions légales complètes

  /confidentialite:
    get:
      operationId: getConfidentialite
      summary: Politique de confidentialité
      description: >
        Politique de confidentialité détaillant la collecte, le traitement et la protection des données personnelles,
        conformément au RGPD.
      tags: [Legal]
      responses:
        "200":
          description: Politique de confidentialité

  /cgv:
    get:
      operationId: getCGV
      summary: Conditions Générales de Vente
      description: >
        Conditions générales de vente d'AMBS Agency : prestations, obligations, responsabilités, modalités financières.
      tags: [Legal]
      responses:
        "200":
          description: Conditions générales de vente

  /unsubscribe:
    get:
      operationId: getUnsubscribe
      summary: Gestion des désinscriptions
      description: >
        Interface permettant de se désinscrire de la newsletter DialAgent ou de demander la suppression complète
        de ses données conformément au RGPD.
      tags: [Legal]
      responses:
        "200":
          description: Page de gestion de la désinscription et de la suppression de données



components:
  schemas:
    Company:
      type: object
      properties:
        name:
          type: string
          example: AMBS Agency
        founded:
          type: string
          example: "2020"
        location:
          type: string
          example: Paris, France
        website:
          type: string
          example: https://ambs-agency.com
        product:
          type: string
          example: DialAgent
        description:
          type: string
          example: Agence française spécialisée en IA conversationnelle et automatisation marketing

    Pricing:
      type: object
      properties:
        starter:
          type: object
          properties:
            price: { type: string, example: "299€/mois" }
            target: { type: string, example: "PME" }
            conversations: { type: string, example: "<1000/mois" }
        growth:
          type: object
          properties:
            price: { type: string, example: "899€/mois" }
            target: { type: string, example: "ETI" }
            conversations: { type: string, example: "1000-10000/mois" }
        enterprise:
          type: object
          properties:
            price: { type: string, example: "Sur devis" }
            target: { type: string, example: "Grands comptes" }
