Endpoints de usuários finais

Os endpoints da API de usuários finais fornecem acesso aos objetos de usuários finais. Um objeto de usuário final é criado para cada usuário final da Contact Center AI Platform (CCAI Platform).

Estes são os endpoints da API Call:

Atualizar usuário final

Com esse endpoint, é possível atualizar os detalhes de um usuário final, incluindo:

  • voce@sua-empresa.com

  • nome

  • número de telefone

{
    "identifier": "string",
    "email": "string",
    "name": "string",
    "phone": "string"
}

Endpoint:

Method: POST
Type: RAW
URL: https://{subdomain}.{domain}/apps/api/v1/end_users

Cabeçalhos:

Chave Valor Descrição
Content-Type application/json
Aceitar application/json

Corpo:

{
    "identifier": "abc123",
    "email": "joe@mydomain.com",
    "name": "Joe Smith",
    "phone": "+16171231234"
}

Exemplo de solicitação e respostas

As seções a seguir fornecem exemplos de solicitações ao endpoint.

ID e identificador do usuário final

Este exemplo mostra como atualizar um usuário final fornecendo o ID.

Solicitação

Cabeçalhos:

Chave Valor Descrição
Content-Type application/json

Corpo:

{
    "identifier": "string",
    "email": "string",
    "name": "string",
    "phone": "string"
}
Resposta
{
    "id": "integer",
    "identifier": "string"
}

Código de status:200

Get end-user

Esse endpoint permite recuperar um usuário final usando id ou identifier.

Endpoint:

Method: GET
Type:
URL: https://{subdomain}.{domain}/apps/api/v1/end_users

Cabeçalhos:

Chave Valor Descrição
Content-Type application/json

Consulta

Chave Valor Descrição
ID integer ID interno do usuário final.
identificador string Identificador externo do usuário final.

Exemplo de solicitação e respostas

As seções a seguir fornecem exemplos de solicitações ao endpoint.

Receber por ID

Este exemplo mostra como recuperar um usuário final fornecendo o ID.

Solicitação

Cabeçalhos:

Chave Valor Descrição
Content-Type application/json

Consulta

Chave Valor Descrição
ID integer ID interno do usuário final.
Resposta
{
    "id": "integer",
    "identifier": "string"
}

Código de status:200

Get by identifier

Este exemplo mostra como recuperar um usuário final fornecendo o identificador.

Solicitação

Cabeçalhos:

Chave Valor Descrição
Content-Type application/json

Consulta

Chave Valor Descrição
identificador string Identificador externo do usuário final.
Resposta
{
    "id": "integer",
    "identifier": "string"
}

Código de status:200