Mango per le aziende

Ordini dal sito — direttamente in Mango

Aggiungete un modulo ordini al vostro sito e ogni richiesta arriverà in Mango come un messaggio normale. Nessuna configurazione server, nessun controllo manuale: l'ordine appare nella lista chat esattamente come un messaggio da una persona.

Come collegare

Aprite le impostazioni

Mango → Impostazioni → Integrazioni con il sito.

Create un token

Premete «Crea token» e date un nome all'integrazione — ad esempio, l'indirizzo del vostro sito. Così capirete da dove arriva l'ordine, se avete più siti.

Copiate il token

Viene mostrato una sola volta — non è possibile recuperarlo, solo revocarlo e crearne uno nuovo.

Inserite il token nel sito

Utilizzate uno dei metodi seguenti, a seconda del vostro sito.

Opzione A: il sito ha un backend

Inviate una singola richiesta HTTP dopo che l'ordine è stato salvato. Conservate il token in una variabile d'ambiente, non nel codice della pagina.

$ch = curl_init('https://api-sg.mango-connect.com/inbound/message');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('MANGO_TOKEN'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'text' => "Заказ №{$id}\nТовар: {$product}\nТелефон: {$phone}",
  ], JSON_UNESCAPED_UNICODE),
]);
curl_exec($ch);
curl_close($ch);

// Node.js
await fetch('https://api-sg.mango-connect.com/inbound/message', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MANGO_TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    text: `Заказ №${id}\nТовар: ${product}\nТелефон: ${phone}`
  }),
});

# Python
import os, requests
requests.post(
    "https://api-sg.mango-connect.com/inbound/message",
    headers={"Authorization": f"Bearer {os.environ['MANGO_TOKEN']}"},
    json={"text": f"Заказ №{order_id}\nТовар: {product}\nТелефон: {phone}"},
    timeout=10,
)

Opzione B: costruttore di siti o CMS

Tilda, Contact Form 7, Shopify e simili possono inviare i dati del modulo a un indirizzo arbitrario, ma non sanno aggiungere intestazioni. Per questi, utilizzate l'indirizzo con il token incorporato e incollatelo nel campo «webhook»:

https://api-sg.mango-connect.com/inbound/message/IL_VOSTRO_TOKEN

Non serve formattare nulla: qualunque cosa il costruttore invii, noi disporremo i campi del modulo in un messaggio leggibile, nello stesso ordine in cui li avete definiti.

Importante da sapere

Non inserite il token nel codice della pagina.

La richiesta deve partire dal server del sito o dal costruttore stesso. Se il modulo contatta Mango direttamente dal browser, il token sarà visibile nel codice sorgente della pagina e chiunque potrà utilizzarlo. Se è già successo, revocate il token nelle impostazioni e createne uno nuovo.

Sulla crittografia

Le conversazioni normali in Mango sono protette da crittografia end-to-end: il server non può leggerle. I messaggi dal sito sono un'eccezione, e questo è un aspetto strutturale del canale, non un difetto. Vengono inviati da un bot di servizio che non possiede chiavi di crittografia, pertanto tali messaggi vengono archiviati e consegnati in chiaro. Nella chat, accanto al nome, è presente l'icona di un lucchetto barrato — indica esattamente questo.

Pertanto, non trasmettete attraverso questo modulo informazioni che non devono essere esposte in chiaro: password, dati di carte bancarie, documenti.

Pronti a collegare?

Aprite Mango, create un token nelle impostazioni e iniziate a ricevere ordini direttamente nel messenger.

Scarica MangoConnect