Vai al contenuto principale

Creare ticket da un'applicazione esterna

La creazione di un ticket da un'applicazione esterna ti consentirà di creare automaticamente una conversazione in Convos con un contatto a partire da un evento o ogni volta che ne hai bisogno.

Requisiti:

Importante:

  • Se al momento della creazione di un ticket esiste già un ticket aperto per lo stesso contatto, non verrà generato un nuovo ticket. Verrà invece aggiunta solo un’osservazione nella chat.
    ​

  • Il ticket viene creato inizialmente con stato Scaduto, poiché non esiste ancora una sessione attiva con il contatto. Il template verrà inviato, ma sarà necessario attendere che il contatto risponda affinché venga aperta la sessione di Meta. Per questo motivo, si consiglia di includere una CTA chiara nei template utilizzati, incoraggiando il contatto a rispondere al messaggio.

Configurazione del request:

Descrizione

Creare ticket da un'appilcazione esterna

HTTP Method

POST

Headers

X-Tenant: {YourXTenant}
Authorization: Bearer {YourToken}

URL


https://api.convos.la/consumer/tickets

JSON request (esempio)

Vedere esempi di seguito

Paginazione e filtraggio (esempio)

none

Esempio:

Descrizione

Creare ticket da un'appilcazione esterna

JSON request (esempio)


{
  "contact": {
    "cellphone": "cellphone"
  },
  "ticket": {
    "project_id": "<projectId>",
    "inbox_id": "<inboxId>",
    "observations": "<observations>"
  },
  "template": {
    "id": "<templateId>",
    "payload": "<payload>"
  }
}

JSON response (esempio)

{}

Un ID del progetto (projectId)

Per ottenere l'ID progetto devi andare nella sezione "Canali" all'interno delle impostazioni del menu utente. Una volta nei canali, fai clic su "Gestire" sul canale WhatsApp.

https://www.app.convos.la/project/settings/channels

Un ID di posta in arrivo (inboxId)

Per ottenere l'ID della posta in arrivo devi andare nella sezione "Conversazioni", poi "Posta in arrivo".

Un ID template preassegnato alla posta in arrivo (templateId)

Andando a modificare una casella di posta in arrivo, è necessario che un template venga ad essa assegnato.

Esempio con i dati negli screenshot:

Descrizione

Creare ticket da un'appilcazione esterna

JSON request (esempio)

{
  "contact": {
    "cellphone": "+5491162584120",
    "name": "Pepe",
    "email": "[email protected]",
    "firstname": "Pepe",
    "lastname": "Ramirez"
  },
  "ticket": {
    "project_id": 1,
    "inbox_id": 1,
    "observations": "Nombre: Pepe \n Empresa: Pepes Company:"
  },
  "template": {
    "id": 1,
    "payload": {
      "language": "es"
    }
  }
}

JSON response (esempio)

{}

Articoli correlati
Hai ricevuto la risposta alla tua domanda?