Importare molti contatti in blocco | Convos

L'importazione di molti contatti in blocco ti consentirà di mantenere aggiornato rapidamente il tuo elenco di contatti.

Requisiti:

Il tuo X-Tenant: https://help.convos.la/it/articles/8452332-x-tenant
Un token con l'abilità "Pubblico": https://help.convos.la/it/articles/8306556-token-di-accesso

Configurazione del request:

Descrizione	Importare molti contatti in blocco
HTTP Method	POST
Headers	X-Tenant: {YourXTenant} Authorization: Bearer {YourToken}
URL	https://api.convos.la/consumer/contacts/import/bulk
Paginazione e filtraggio (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_cellphones 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_cellphones": true }

Esempi:

Descrizione	Importare contatti in blocco in modo generico
JSON request (esempio)	{ "contacts": [ { "cellphone": "<cellphone1>", "fields": [ { "id": 1, "value": "<value1>" } ] }, { "cellphone": "<cellphone2>", "fields": [ { "id": 1, "value": "<value2>" } ] } ] }
JSON response (ejemplo)	{}

Descrizione

Importare molti contatti in blocco a uno o più gruppi specifici

JSON request (esempio)

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

JSON response (ejemplo)

{}

Descrizione

Importa molti contatti in blocco in un gruppo per nome; se non esiste, il gruppo verrà creato immediatamente.

JSON request (esempio)

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

JSON response (ejemplo)

{}