I tuoi dati

Assistenza

Il tuo telefono e la tua email, gli orari dei tuoi operatori, dove arrivano le richieste di una persona.

A che cosa serve nella conversazione

Quando un cliente chiede una persona, l'assistente registra una richiesta d'assistenza e gli dice quando i tuoi operatori risponderanno; se chiede come raggiungerti, gli dà il tuo telefono e la tua email.

Le richieste d'assistenza ti arrivano per webhook o le ritiri con l'API (pull), come gli ordini. Con i soli ordini per email le richieste non arrivano: l'email porta solo gli ordini, e la pagina Dove ricevere gli ordini lo dice.

Esempio

Cliente: Posso parlare con qualcuno?

Assistente: Certo: ho avvisato i miei colleghi, ti ricontattano negli orari del servizio clienti (lun-ven 9:00-12:30). Puoi anche chiamarli allo 000 000 0000.

Telefono, email e orari di un negozio inventato. Esempio illustrativo, coi prodotti del modello e un negozio inventato.

Che cosa succede se manca

  • Senza telefono ed email il cliente che vuole raggiungerti non ha un contatto.
  • Senza orari degli operatori l'assistente dice che verrà ricontattato, senza dire quando.
  • Senza una via per le richieste d'assistenza (webhook o pull) il cliente che chiede una persona non viene richiamato: tu non sai che l'ha chiesto.

I campi

Obbligatorio: senza, il prodotto non si vende come il cliente se l'aspetta. Consigliato: senza, c'è un ripiego dichiarato, ma l'esperienza è più povera. Facoltativo: un miglioramento.

Assistenza (Impostazioni del negozio e Dove ricevere gli ordini)

  • support.phoneconsigliato
    Tipo
    telefono
    Esempio
    000 000 0000
    Regola
    Il numero che il cliente può chiamare (in arrivo in Impostazioni del negozio).
  • support.emailconsigliato
    Tipo
    email
    Esempio
    assistenza@esempio.it
    Regola
    L'indirizzo a cui il cliente può scrivere.
  • support.hoursconsigliato
    Tipo
    finestre per giorno
    Esempio
    Mon-Fri 9:00-12:30
    Regola
    Giorni da 0 (domenica) a 6, inizio prima della fine, nel tuo fuso.
  • support_requestsobbligatorio
    Tipo
    via
    Esempio
    webhook
    Regola
    Webhook (support.requested) o pull (GET /v1/support_requests).

Errori frequenti e il loro messaggio

  • ORARI_NON_VALIDI

    «Controlla gli orari: per ogni fascia servono i giorni e un'ora d'inizio prima di quella di fine.»

    Che cosa fare: Gli orari sono finestre con giorni, dalle e alle: non testo libero.

  • EMAIL_NON_VALIDA

    «Questo indirizzo email non è scritto bene: controllalo.»

    Che cosa fare: nome@dominio.

Come mandarli

  • Dal portaleIn parte

    Oggi: l'email dell'assistenza in Impostazioni del negozio; dove arrivano le richieste in Dove ricevere gli ordini (webhook) e Sviluppatori. In arrivo: il telefono e gli orari degli operatori, nella forma che l'assistente legge (giorni e finestre).

  • Dall'APIDisponibile

    GET /v1/support_requests e POST /v1/support_requests/{id}/ack (orders:read, orders:write) per ritirare le richieste in pull.

Disponibilità misurata sul servizio vivo il 30 ottobre 2026.

Documentazione dell'API