Documentazione dell'API

Apre una richiesta di collegamento e restituisce il collegamento di approvazione da presentare all'esercente.

curl -X POST 'https://louis.guide/api/v1/pairing' \
  -H 'Content-Type: application/json' \
  --data-raw '{"shop_domain":"boutique.exemple.fr","platform":"prestashop","shop_name":"Tissu Fiesta","platform_version":"8.1.6","plugin_version":"1.2.0","shop_uid":"ps-7f3a91c4"}'

HTTP/1.1 201 Created

{
  "code": "4K7M-9QR3",
  "poll_token": "pt_8f2c1a7e5b2d48a6c3d9e0f1a2b3c4d5",
  "expires_at": "2026-08-13T15:07:44+00:00",
  "approve_url": "https://louis.guide/app/raccordement/4K7M-9QR3"
}

• approve_url — da aprire in una nuova scheda del browser dell'esercente, fuori dal suo back office. È lì che si connette o crea il suo conto, poi approva.
• poll_token — da conservare unicamente lato server. Non deve mai comparire in una pagina né in un URL: è ciò che permetterà di recuperare il segreto.
• code — mostrabile all'esercente, perché verifichi di approvare la richiesta giusta.

Codici d'errore

Interroga lo stato della richiesta e consegna la chiave una volta — e una sola — che l'esercente abbia approvato.

In POST benché sia una lettura, perché la chiamata ha un effetto collaterale: consuma il segreto. In GET, un precaricatore del browser o un antivirus che segue i collegamenti lo consumerebbe al posto del modulo.

curl -X POST 'https://louis.guide/api/v1/pairing/4K7M-9QR3' \
  -H 'Content-Type: application/json' \
  --data-raw '{"poll_token":"pt_8f2c1a7e5b2d48a6c3d9e0f1a2b3c4d5"}'

In attesa di approvazione:

HTTP/1.1 200 OK

{ "status": "pending" }

Approvato — le credenziali sono consegnate solo a questa chiamata:

HTTP/1.1 200 OK

{
  "status": "approved",
  "api_key": "ak_live_5c2f81b0",
  "secret": "sk_live_3f9c1a7e5b2d48a6",
  "merchant": "tissufiesta"
}

Valori possibili di status

Sempre 200, anche per uno stato di attesa. Il modulo interroga in ciclo: un codice HTTP d'errore su una situazione perfettamente normale farebbe salire allarmi per nulla. Interrogate ogni cinque secondi; il limite è di 240 chiamate per quarto d'ora e per IP — oltre, la risposta è { "status": "rate_limited" } con stato 429.

Verifica che una chiave funzioni. È la prima chiamata da scrivere, e quella da proporre all'esercente sotto forma di pulsante « Testare la connessione »: meglio che scopra una chiave errata alla configurazione anziché al primo ordine non trasmesso.

Senza firma, volutamente. Una lettura non modifica nulla, e soprattutto: questo endpoint deve restare utilizzabile per provare che una chiave sia buona mentre l'implementazione HMAC è ancora errata. Il ping passa, la scrittura no: il problema è nella firma, non nella chiave.

curl 'https://louis.guide/api/v1/cms/ping' \
  -H 'X-Api-Key: ak_live_5c2f81b0'

HTTP/1.1 200 OK

{
  "status": "ok",
  "merchant": "tissufiesta",
  "api_key": "ak_live_5c2f81b0",
  "server_time": "2026-08-13T14:52:07+00:00"
}

server_time è restituito per una ragione precisa: confrontatelo con l'orologio del vostro server. Uno scarto superiore a 300 secondi farà fallire tutte le vostre scritture firmate (§2.3), ed è qui che lo si vede prima di perderci una giornata.

Stato del conto: identità dell'esercente, capacità del piano, quota e indirizzi della piattaforma.

curl 'https://louis.guide/api/v1/cms/me' \
  -H 'X-Api-Key: ak_live_5c2f81b0'

HTTP/1.1 200 OK

{
  "merchant": {
    "uuid": "0f1c2b3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
    "slug": "tissufiesta",
    "display_name": "Tissu Fiesta",
    "country": "FR",
    "default_locale": "fr",
    "timezone": "Europe/Paris",
    "status": "active"
  },
  "plan": {
    "code": "pro",
    "can_display_product_reviews": true,
    "can_use_photos": true,
    "can_use_reviews_api": true,
    "can_remove_branding": true
  },
  "quota": {
    "year": 2026,
    "allowance": 5000,
    "used": 1284,
    "remaining": 3716,
    "resets_at": "2027-01-01T00:00:00+00:00"
  },
  "urls": {
    "api": "https://louis.guide",
    "dashboard": "https://louis.guide/app",
    "widget": "https://louis.guide/widget/v1/avis.js",
    "profile": "https://louis.guide/it/m/tissufiesta"
  },
  "server_time": "2026-08-13T14:52:07+00:00"
}

Leggete le capacità, non il nome del piano

Il blocco plan espone delle capacità (can_…) oltre al codice del piano. Verificate le prime: un modulo che scrive in duro if (plan === 'pro') smetterà di essere corretto il giorno in cui un piano si aggiunge o cambia nome, presso tutti gli esercenti nello stesso momento e senza che nessuno possa correggerlo.

Il blocco urls evita di indovinare

La vostra integrazione deve conoscere un solo indirizzo: quello dell'API. Gli altri — area esercente, script dei widget, pagina pubblica dell'esercente — sono restituiti qui. Un modulo che li ricompone a partire da una base unica presuppone che tutto viva sullo stesso host, cosa che smette di essere vera non appena un canale passa a un sottodominio, e produce collegamenti morti presso tutti gli esercenti già installati.

quota.remaining merita una visualizzazione nella vostra interfaccia: a zero gli ordini continuano a essere accettati ma non parte più alcun sollecito. Avvisare al 90 % di consumo evita all'esercente di scoprirlo dalle sue statistiche.

L'endpoint centrale. Registra un ordine e pianifica la richiesta di recensione. Tutto il resto della piattaforma discende da questa chiamata: senza di essa non c'è né sollecito, né recensione, né voto.

Quando chiamare

Nel momento in cui l'esperienza è vissuta, non ordinata: alla consegna, alla spedizione a seconda del vostro mestiere, o al passaggio allo stato che ne fa le veci. È experienced_at a portare questa data, ed è essa a far partire il termine di sollecito.

Corpo della richiesta

Radice

customer

source — obbligatorio

Questo blocco non è statistica. Quando un esercente scrive « le mie recensioni non partono più dall'aggiornamento », la risposta è già lì dentro: versione della piattaforma, versione del modulo, evento scatenante. Renderlo facoltativo equivarrebbe a non averlo mai — gli integratori compilano ciò che è richiesto, non ciò che è suggerito.

items[] — facoltativo, 200 articoli al massimo

Esempio completo

POST /api/v1/cms/orders
X-Api-Key: ak_live_5c2f81b0
X-Timestamp: 1786000000
X-Signature: sha256=…
Content-Type: application/json

{
  "external_order_id": "CMD-1042",
  "experienced_at": "2026-08-06T09:15:00+02:00",
  "amount": "129.90",
  "currency": "EUR",
  "order_status_id": "5",
  "order_status_label": "Livré",
  "customer": {
    "email": "claire.martin@exemple.fr",
    "first_name": "Claire",
    "last_name": "Martin",
    "locale": "fr",
    "country": "FR",
    "postal_code": "69003",
    "city": "Lyon"
  },
  "items": [
    {
      "external_product_id": "REF-42",
      "variant_id": "REF-42-ROUGE-L",
      "variant_label": "Couleur : rouge, Taille : L",
      "name": "Nappe en lin lavé",
      "sku": "NAP-LIN-42",
      "gtin": "3401579874120",
      "brand": "Tissu Fiesta",
      "quantity": 2,
      "unit_price": "64.95",
      "product_url": "https://boutique.exemple.fr/nappe-lin-42",
      "image_url": "https://boutique.exemple.fr/img/nappe-42.jpg"
    }
  ],
  "source": {
    "platform": "prestashop",
    "platform_version": "8.1.6",
    "plugin_version": "1.2.0",
    "trigger": "actionOrderHistoryAddAfter",
    "shop_uid": "ps-7f3a91c4",
    "shop_id": "1",
    "shop_name": "Tissu Fiesta"
  }
}

Ordine registrato:

HTTP/1.1 201 Created

{
  "uuid": "3b8e1f42-6c7d-4e9a-91b2-5d0c3a7f4e18",
  "external_order_id": "CMD-1042",
  "status": "pending",
  "channel": "ecommerce_order",
  "experienced_at": "2026-08-06T07:15:00+00:00",
  "imported_at": "2026-08-06T09:41:22+00:00",
  "items_count": 1,
  "idempotent": false
}

Stessa richiesta riprodotta:

HTTP/1.1 200 OK

{ "…": "…", "idempotent": true }

L'indirizzo email non è mai restituito, anche se l'avete appena trasmesso: ogni dato restituito è un dato che può trapelare nei vostri stessi registri.

Valori possibili di status

Errori

Questo endpoint è l'unico servito da API Platform: i suoi errori di validazione arrivano quindi sotto forma di elenco di violations, e non nella busta { "error": … } del resto dell'API. Il vostro codice deve accettare entrambe le forme.

HTTP/1.1 422 Unprocessable Content

{
  "status": 422,
  "detail": "customer.email: \"claire.martin\" n'est pas une adresse email valide.",
  "violations": [
    {
      "propertyPath": "customer.email",
      "message": "\"claire.martin\" n'est pas une adresse email valide."
    }
  ]
}

Elenca le recensioni dell'esercente, dalla più recente alla più antica, con la risposta pubblicata e l'eventuale segnalazione di ciascuna. È questo endpoint che permette di riportare le recensioni in un ERP, un CRM o uno strumento di assistenza clienti.

curl 'https://louis.guide/api/v1/cms/reviews?status=published&per_page=50' \
  -H 'X-Api-Key: ak_live_5c2f81b0'

HTTP/1.1 200 OK

{
  "reviews": [
    {
      "id": "9f1c2b3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
      "score": 4,
      "title": "Livraison rapide",
      "comment": "Nappe conforme, le lin est épais. Un pli à la livraison.",
      "author": "Claire M.",
      "language": "fr",
      "country": "FR",
      "status": "published",
      "verified_purchase": true,
      "experienced_at": "2026-08-06T07:15:00+00:00",
      "submitted_at": "2026-08-13T18:02:41+00:00",
      "published_at": "2026-08-13T18:04:10+00:00",
      "order_reference": "CMD-1042",
      "response": {
        "content": "Merci Claire, nous notons pour l'emballage.",
        "created_at": "2026-08-14T08:11:00+00:00",
        "updated_at": null
      },
      "report": null
    }
  ],
  "page": 1,
  "per_page": 50,
  "total": 318
}

Le tre date, e perché sono tre

experienced_at (l'esperienza vissuta), submitted_at (il deposito) e published_at (la messa in linea) sono tre cose diverse, e l'AFNOR impone di poterle distinguere. Un integratore che le confonde mostra « 3 giorni fa » su un'esperienza vecchia di tre settimane. published_at vale null finché la recensione non è pubblicata.

order_reference riprende il vostro external_order_id: è ciò che collega la recensione all'ordine nel vostro sistema. Vale null per una recensione depositata al di fuori di un sollecito.

Sincronizzazione incrementale

Interrogate con status=published e confrontate published_at con l'ultimo passaggio: riportare tutto lo storico a ogni esecuzione funziona i primi mesi, poi diventa una richiesta di diverse migliaia di righe ogni ora. La paginazione comincia da 1 e il campo total dà il numero di recensioni corrispondenti al filtro, non il numero di pagine.

Pubblica una risposta pubblica a una recensione sull'insegna, o aggiorna quella già esistente. Una recensione porta una sola risposta: riemettere sostituisce il testo.

curl -X POST 'https://louis.guide/api/v1/cms/reviews/9f1c2b3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d/response' \
  -H 'X-Api-Key: ak_live_5c2f81b0' \
  -H 'X-Timestamp: 1786000000' \
  -H 'X-Signature: sha256=…' \
  -H 'Content-Type: application/json' \
  --data-raw '{"content":"Merci Claire, nous notons pour l’emballage."}'

HTTP/1.1 201 Created

{
  "review_id": "9f1c2b3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
  "response": {
    "content": "Merci Claire, nous notons pour l'emballage.",
    "created": true,
    "status": "published",
    "published": true
  }
}

201 alla creazione, 200 all'aggiornamento; il campo created riporta la stessa informazione nel corpo. Una risposta già pubblicata lo resta: un aggiornamento non la riporta mai in bozza, il che la farebbe sparire dalla pagina senza che nessuno l'abbia deciso.

Segnala una recensione per moderazione. La recensione passa allo stato « contestata » e il fascicolo entra nella coda d'istruttoria.

Motivi ammissibili

HTTP/1.1 202 Accepted

{
  "review_id": "9f1c2b3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
  "report": {
    "reason": "off_topic",
    "status": "pending",
    "review_remains_visible": true
  }
}

review_remains_visible vale sempre true, e il campo esiste perché nessuna interfaccia sia concepita presupponendo il contrario: la recensione resta pubblica per tutta l'istruttoria. Toglierla su semplice segnalazione equivarrebbe a lasciare che l'esercente svaluti ciò che gli dispiace — Google lo vieta esplicitamente, l'AFNOR anche. La risposta è un 202: la domanda è registrata, non decisa.

Voto globale del negozio e ripartizione per voto.

curl 'https://louis.guide/api/v1/public/merchants/tissufiesta/score'

HTTP/1.1 200 OK
Cache-Control: public, max-age=60

{
  "merchant": { "slug": "tissufiesta", "name": "Tissu Fiesta" },
  "score": {
    "average": 4.6,
    "count": 318,
    "distribution": { "1": 4, "2": 6, "3": 18, "4": 91, "5": 199 },
    "scale": { "min": 1, "max": 5 }
  }
}

scale è restituito esplicitamente anziché sottinteso: un integratore che programma « su 10 » perché il suo precedente fornitore lo era produce una visualizzazione falsa che nessuno rilegge. count conta soltanto le recensioni pubblicamente visibili.

404 merchant_not_found se lo slug è sconosciuto.

Recensioni sull'insegna, dalla più recente alla più antica.

HTTP/1.1 200 OK

{
  "reviews": [
    {
      "id": "9f1c2b3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
      "author": "Claire M.",
      "score": 4,
      "title": "Livraison rapide",
      "comment": "Nappe conforme, le lin est épais. Un pli à la livraison.",
      "language": "fr",
      "verified_purchase": true,
      "experienced_at": "2026-08-06",
      "submitted_at": "2026-08-13",
      "published_at": "2026-08-13",
      "disputed": false,
      "photos": [
        {
          "id": "6d2a1f80-9b3c-4d5e-8f70-1a2b3c4d5e6f",
          "url": "https://louis.guide/photos/6d2a1f80-9b3c-4d5e-8f70-1a2b3c4d5e6f",
          "thumbnail_url": "https://louis.guide/photos/6d2a1f80-9b3c-4d5e-8f70-1a2b3c4d5e6f/thumb",
          "width": 1600,
          "height": 1200
        }
      ],
      "reply": {
        "content": "Merci Claire, nous notons pour l'emballage.",
        "published_at": "2026-08-14"
      }
    }
  ],
  "page": 1,
  "per_page": 10
}

Ciò che la vostra visualizzazione deve riprendere

• Due date come minimo — quella dell'esperienza e quella della pubblicazione. È un obbligo di visualizzazione, e solo l'API può fornirvele. Le date pubbliche sono ridotte al giorno (2026-08-06): nessun widget mostra l'ora.
• verified_purchase — la recensione è collegata a un ordine reale. È ciò che distingue una recensione raccolta da una depositata spontaneamente.
• disputed — la recensione è contestata e la sua istruttoria è in corso. Resta visualizzata (vedere §4.6); segnalatela anziché nasconderla.
• reply — la risposta dell'esercente fa parte della recensione per il lettore. published_at vi porta la data dell'ultima modifica quando ve n'è stata una: mostrare la data d'origine sotto un testo riscritto trarrebbe in inganno.
• photos — vuoto presso un esercente il cui piano non le serve. Le recensioni restano complete, mancano solo le immagini.

Su questo canale non esiste un campo total: una pagina vuota significa che non c'è più nulla da caricare. È ciò che fa il pulsante « vedi altro » del widget.

Voto di un prodotto. {productId} è il vostro identificatore di catalogo, quello trasmesso in external_product_id — non lo riscriviamo mai. Ricordate di codificarlo se contiene caratteri riservati.

curl 'https://louis.guide/api/v1/public/products/tissufiesta/REF-42/score?with_variants=true'

HTTP/1.1 200 OK

{
  "product": { "external_id": "REF-42", "variant_id": null },
  "score": {
    "average": 4.4,
    "count": 27,
    "distribution": { "1": 0, "2": 1, "3": 3, "4": 7, "5": 16 },
    "scale": { "min": 1, "max": 5 }
  },
  "variants": [
    { "variant_id": "REF-42-ROUGE-L", "average": 4.8, "count": 12 },
    { "variant_id": "REF-42-BLEU-M", "average": 4.1, "count": 15 }
  ]
}

variants vale null quando with_variants non è richiesto — è un'assenza di calcolo, non un'assenza di varianti.

Recensioni di un prodotto. Stessa struttura di risposta e stessi parametri di paginazione delle recensioni sull'insegna, più il filtro variant — utile quando un selettore di taglia vuole mostrare solo le recensioni della variante scelta.

curl 'https://louis.guide/api/v1/public/products/tissufiesta/REF-42/reviews?variant=REF-42-ROUGE-L&per_page=5'

Presso un esercente il cui piano non includa la visualizzazione delle recensioni prodotto, prevedete una visualizzazione che si riduca in modo pulito anziché una cornice vuota: il widget, dal canto suo, sparisce dalla pagina.

Foto dei clienti approvate, senza il testo delle recensioni. È ciò che alimenta un carosello: senza questo endpoint bisognerebbe caricare cinquanta recensioni complete — testo, date, voti — per conservarne solo le immagini, su una scheda prodotto che carica già il tema dell'esercente.

HTTP/1.1 200 OK

{
  "photos": [
    {
      "id": "6d2a1f80-9b3c-4d5e-8f70-1a2b3c4d5e6f",
      "url": "https://louis.guide/photos/6d2a1f80-9b3c-4d5e-8f70-1a2b3c4d5e6f",
      "thumbnail_url": "https://louis.guide/photos/6d2a1f80-9b3c-4d5e-8f70-1a2b3c4d5e6f/thumb",
      "width": 1600,
      "height": 1200
    }
  ]
}

Gli URL sono assoluti: questo JSON è letto da JavaScript eseguito sul dominio del negozio, dove un URL relativo punterebbe al negozio stesso. Servitevi di width e height per riservare lo spazio prima del caricamento — altrimenti la scheda prodotto salterà sotto gli occhi del visitatore.

Presso un esercente il cui piano non serve le foto, la risposta è { "photos": [] } con stato 200, mai un errore: il carosello sparisce in modo pulito anziché mostrare una cornice fallita.

Impostazioni di visualizzazione decise dall'esercente nella sua area. È ciò che permette di collocare i tag una volta per tutte in un tema, poi di accendere, spegnere o spostare un elemento senza toccare il codice del negozio.

HTTP/1.1 200 OK
Cache-Control: public, max-age=300

{
  "merchant": {
    "slug": "tissufiesta",
    "name": "Tissu Fiesta",
    "accent_color": "#7c3aed"
  },
  "display": {
    "badge_flottant": false,
    "badge_cote": "droite",
    "badge_decalage": 16,
    "seuil_avis": 1,
    "etoiles_fiche": true,
    "etoiles_vignettes": true,
    "onglet_avis": true,
    "bloc_accueil": true
  },
  "profile_url": "https://louis.guide/it/m/tissufiesta"
}

display è sempre completo, valori predefiniti inclusi: il vostro codice non deve conoscere i nostri valori predefiniti né ricopiarli — il giorno in cui uno cambierà, li seguirà.

accent_color vale null quando l'esercente non ha scelto un colore oppure quando il suo piano non lo consente più. Prevedete sempre un colore di ripiego dal vostro lato: è ciò che fa il widget, la cui tinta esiste solo se dichiarata.

Disponibilità del servizio. Da interrogare con una sonda o con il controllo di salute di un modulo.

HTTP/1.1 200 OK

{ "status": "ok" }

Volutamente minimo: nessun accesso alla banca dati, nessuna dipendenza esterna. Una lentezza della banca dati non deve scatenare un falso allarme di indisponibilità — e viceversa, questo endpoint non dice nulla sullo stato della banca dati. Per verificare che una chiave funzioni, è /cms/ping che va chiamato.

Recensioni pubblicate sull'insegna, dalla più recente alla più antica. Lo strumento che l'assistente chiama per « mostrami i clienti scontenti » o « che cosa non ha ancora risposta? ».

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "lister_avis",
    "arguments": { "note_max": 3, "sans_reponse": true, "limite": 10 }
  }
}

Il risultato è un blocco di testo contenente JSON — è la forma che il protocollo prevede per un risultato strutturato, e quella che gli assistenti sanno leggere:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"avis\":[{\"id\":\"9f1c2b3d-…\",\"note\":2,\"titre\":\"Colis abîmé\",\"commentaire\":\"…\",\"langue\":\"fr\",\"auteur\":\"Claire M.\",\"publie_le\":\"2026-08-13\",\"deja_repondu\":false}],\"total\":1}"
      }
    ],
    "isError": false
  }
}

Qui risalgono soltanto le recensioni pubblicate: né quelle in attesa, né le rifiutate, né le ritirate. Per quelle c'è GET /cms/reviews con il suo filtro status.

Visione d'insieme, senza argomento. Ciò che l'assistente chiama per « come va la mia reputazione? ».

{
  "boutique": "Tissu Fiesta",
  "note_moyenne": 4.6,
  "avis_publies": 318,
  "repartition": { "1": 4, "2": 6, "3": 18, "4": 91, "5": 199 },
  "avis_produit": 127
}

avis_publies conta le recensioni sull'insegna; avis_produit conta separatamente quelle che riguardano un articolo. Sommarle darebbe un totale che non corrisponde ad alcun voto mostrato.

{
  "avis_id": "9f1c2b3d-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
  "publiee": false,
  "message": "Risposta salvata in bozza. L'esercente deve approvarla nella sua area prima che compaia."
}

Una recensione già dotata di risposta vede la propria risposta sostituita. Una risposta già pubblica lo resta: una riscrittura non la rimanda mai in bozza, il che la farebbe sparire dalla pagina senza decisione di nessuno.

Ciò che un assistente deve sapere prima di scrivere

• Rispondere nella lingua della recensione — il campo langue serve a questo. Una risposta in francese sotto una recensione in neerlandese dice al lettore che non è stata letta.
• Non promettere mai un gesto commerciale che non si possa onorare: rimborso, sostituzione, sconto. Questa risposta è pubblica e opponibile all'esercente.
• Nessuno strumento modifica né elimina una recensione, e non ce ne saranno. Un assistente cui si chieda di « far togliere » una recensione può soltanto segnalarla, con un motivo ammissibile (§4.6) — il voto non lo è.

Riceve gli eventi di abbonamento: checkout.session.completed, customer.subscription.created, .updated e .deleted. È ciò che fa passare un conto al piano a pagamento, e quindi ciò che apre l'API recensioni e l'accesso MCP.

La firma del carico utile è l'unica cosa che protegge questa rotta: senza di essa chiunque potrebbe inviare « abbonamento attivo » e offrirsi il piano a pagamento con una sola richiesta curl. È verificata prima di ogni lettura del contenuto, e un segreto assente fa fallire la richiesta anziché lasciarla passare.

Gli eventi non trattati sono confermati con un 200 ({ "ignored": … }): Stripe considera ogni risposta non-2xx come un fallimento e ripete per tre giorni, a intervalli crescenti. Rispondere 404 a un tipo di evento che non ci serve provocherebbe migliaia di rinvii inutili, poi la disattivazione dell'endpoint dal loro lato. Al contrario, un vero fallimento di trattamento risponde sì 500 — lì vogliamo che Stripe ripeta anziché lasciare in piano gratuito un esercente che ha pagato.

Riceve gli SMS in entrata, cioè gli « STOP ». L'operatore tratta la parola chiave dal suo lato e smette di consegnare — ma senza questo endpoint noi non ne sapremmo nulla: continueremmo a inviargli messaggi fatturati e mai ricevuti, l'opposizione sparirebbe il giorno di un cambio di operatore, e non potremmo provare di averla onorata mentre l'onere della prova spetta a noi.

Il token viaggia nel percorso, il che è più debole di una firma — ma è ciò che le interfacce degli operatori francesi sanno configurare. Da qui il fatto che questo endpoint non possa fare altro che aggiungere un'opposizione: il peggio che una chiamata fraudolenta produca è impedire l'invio di SMS a un numero. Fastidioso, mai pericoloso, e reversibile dal back office.

La parola chiave è cercata come prima parola del messaggio, non ovunque al suo interno: chi scrive « deve smetterla, quel negozio fa schifo » non chiede di essere cancellato, e cancellarlo d'ufficio gli toglierebbe il canale attraverso cui viene legittimamente contattato. L'opposizione è registrata per tutti gli esercenti: il messaggio in entrata non dice di quale negozio si tratti — la persona risponde al numero di invio — e indovinare sarebbe insieme falso e pericoloso.

Taglia soltanto il canale SMS. L'email continua a partire: è quella che porta il collegamento di gestione della recensione e le menzioni obbligatorie, e un'opposizione espressa su un canale non vale per l'altro.