Vai al contenuto principale

Importare un singolo contatto

Aggiornato oltre 3 mesi fa

L'importazione di un contatto singolo ti permetterà di mantenere aggiornata la tua lista di contatti.

Requisiti:

Configurazione della richiesta:

Descrizione

Importare un singolo contatto

HTTP Method

POST

Headers

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

URL

https://api.convos.la/consumer/contacts/import/single

JSON request (esempio)

Vedi gli esempi qui sotto.

Paginazione e filtro

(esempio)

none

Parametri aggiuntivi

Campo:

Field: import_type

Values: subscribed | unsubscribed

Type: String

Default: subscribed

​Descrizione:

Questo parametro consente di eseguire l'importazione per annullare l'iscrizione dei contatti; per impostazione predefinita, sarà sempre utilizzato per importare nuovi contatti o aggiornare quelli esistenti.

{
  "import_type": "unsubscribed"
}

Campo:

Field: subscribe_force

Values: true | false

Type: Boolean

Default: false

​Descrizione:

Questo parametro consente di riattivare un numero di telefono attualmente disattivato.

{
  "subscribe_force": true
}

Campo:

Field: try_fix_cellphone

Values: true | false

Type: Boolean

Default: false


​Descrizione:

Questo parametro consente di correggere automaticamente il numero di telefono quando non è in formato internazionale, in modo che il contatto possa essere importato correttamente.

{
  "try_fix_cellphone": true
}

Esempio:

Descrizione

Importa un singolo contatto in modo generale.

JSON request (esempio)

{
  "cellphone": "<cellphone>",
  "fields": [
    {
      "id": 1,
      "value": "<value1>"
    }
  ]
}

JSON response (esempio)

{}

Descrizione

Importa un singolo contatto in un gruppo specifico o in più gruppi.

JSON request (esempio)

{
  "group_id": [
    <Group ID 1>,
    <Group ID 2>
  ],
  "cellphone": "<cellphone>",
  "fields": [
    {
      "id": 1,
      "value": "<value1>"
    }
  ]
}

JSON response (esempio)

{}

Descrizione

Importa un singolo contatto in un gruppo per nome; se il gruppo non esiste, verrà creato al momento.

JSON request (esempio)

{
  "group_name": "<Group Name>",
  "cellphone": "<cellphone>",
  "fields": [
    {
      "id": 1,
      "value": "<value1>"
    }
  ]
}

JSON response (esempio)

{}

Articoli correlati
Invia messaggi transazionali
Importare molti contatti in blocco
Esportare contatti
Gruppi
Creare ticket da un'applicazione esterna
Hai ricevuto la risposta alla tua domanda?