CRM Contacts Read¶

API CRM Contacts se foloseste pentru a citi lista de contacte din CRM

API URL¶

https://[YOUR-PBX-URL]/api/crm-contacts

Datele se trasmit prin POST sau GET si trebuie sa fie de forma:¶

Array
(
    [action] => read
    [page] => 1
    [filters] => Array
        (
            [project_id] =>
            [crm_type_id] =>
            [search] =>
            [status] => 
        )

    [api_hash] => 07112231a9c89f5b108af08608a97b07
)

Parametrul action trebuie sa aiba valoarea read. Parametrul page este implicit 1, va trebui incrementat pentru a extrage datele de pe toate paginile.

Headere HTTP:¶

Content-Type: text/xml
Authorization: Bearer <token>

Filtre:¶

• project_id: ID proiect in centrala
• crm_type_id: ID CRM Type in centrala
• search: Cautare dupa numar de telefon, ID sau nume
• status: Status contact

Exemplu generare parametri:

$params = array(
    'action' => 'read',
    'page' => 1,
    'filters' => array(
        'project_id' => null,
        'crm_type_id' => null,
        'search' => null,
        'status' => 'valid', // -1 = All
    )
);

Exemplu generare hash:

$params['api_hash'] = md5(http_build_query($params) . 'your_api_key'); // make hash

Exemplu trimitere date:

$url = 'https://[YOUR-PBX-URL]/api/crm-contacts';
$token = 'your_api_token';
echo curlPost($url, http_build_query($params), array("Authorization: Bearer {$token}"));

Raspuns¶

In caz de succes:

{

    "has_error": false,
    "messages": [ ],
    "pagination": {
        "row_count": 0,
        "page_size": 100,
        "current_page": 0,
        "max_page": 0
    },
  "results": [
    {
      "id": "3",
      "project_id": "1",
      "name": "John Doe",
      "crm_type_id": "1",
      "title": null,
      "company": null,
      "avatar": null,
      "email": null,
      "website": null,
      "address": null,
      "queue_position": null,
      "direct_line": null,
      "skip_welcome": null,
      "skip_enter_queue": null,
      "monitor_option": null,
      "language": "ro",
      "we_are_recording_message": "asdasda",
      "assigned_user_id": null,
      "comments": null,
      "created": "2018-01-04 13:39:26",
      "start_date": null,
      "end_date": null,
      "call_parameters": null,
      "source_uniqueid": null,
      "source_inbound_route_id": null,
      "added_by": null,
      "parser_id": null,
      "parser_md5": null,
      "remote_id": null,
      "purge_date": null,
      "status": "active",
      "telephones": [
        "0712345678" 
      ],
      "added_by_name": null,
      "assigned_user_name": null,
      "assigned_user_email": null,
      "parser_name": null,
      "project_name": "While1" 
    }
  ]
}

}

Sau in caz de eroare:

{

    "has_error": true,
    "messages": [
        "Invalid filter: project_idxx" 
    ],
    "pagination": [ ],
    "results": [ ]

}

---

Disponibil si in alte limbi: EN