Mettre a jour la file courante

curl --request PATCH \
  --url https://api.withallo.com/v2/api/dialing-queues/current \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Cold Calls"
}
'

{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "creator_id": "<string>",
    "assignee_id": "<string>",
    "numbers": [
      {
        "number_to": "<string>",
        "position": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "call_start_date": "2023-11-07T05:31:56Z",
        "call_id": "<string>",
        "detected_outbound_voicemail": true,
        "voicemail_left": true
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "not_found_error",
    "code": "ASSIGNEE_NOT_FOUND",
    "message": "No team member found for the provided 'user_id' or 'email'.",
    "retryable": false,
    "suggestion": "List your teammates with GET /v2/api/users and use one of their ids as 'user_id', or pass a team-member email."
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

PATCH

api

dialing-queues

current

curl --request PATCH \
  --url https://api.withallo.com/v2/api/dialing-queues/current \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Cold Calls"
}
'

{
  "data": {
    "id": "<string>",
    "name": "<string>",
    "creator_id": "<string>",
    "assignee_id": "<string>",
    "numbers": [
      {
        "number_to": "<string>",
        "position": 123,
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "call_start_date": "2023-11-07T05:31:56Z",
        "call_id": "<string>",
        "detected_outbound_voicemail": true,
        "voicemail_left": true
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "not_found_error",
    "code": "ASSIGNEE_NOT_FOUND",
    "message": "No team member found for the provided 'user_id' or 'email'.",
    "retryable": false,
    "suggestion": "List your teammates with GET /v2/api/users and use one of their ids as 'user_id', or pass a team-member email."
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

Cibler la file d’un coequipier

Par defaut, cet endpoint met a jour la config de la file assignee au proprietaire de la cle API. Pour mettre a jour la file d’un coequipier, envoyez user_id ou email dans le corps JSON. Le coequipier doit appartenir a la meme equipe que le proprietaire de la cle API.

user_id — l’emporte quand les deux sont fournis. Resolvez les ids des coequipiers via GET /v2/api/users.
email — utilise uniquement quand user_id est absent.

Si l’utilisateur resolu n’est pas dans votre equipe, la reponse est 404 ASSIGNEE_NOT_FOUND.

Autorisations

Authorization

string

header

requis

Corps

application/json

Creates or updates the queue config. All fields are optional — only the fields you supply are touched. Pass user_id or email to act on a teammate's queue instead.

name

string | null

New queue name (1–255 characters)

Required string length: 1 - 255

voicemail_handling

enum<string> | null

How the Power Dialer reacts when the call hits voicemail.

Options disponibles:

SKIP,

NO_SKIP

do_not_disturb

enum<string> | null

Silence inbound calls while running the queue.

Options disponibles:

ENABLED,

DISABLED

user_id

string | null

Optional. ID of a teammate whose queue config should be updated. The teammate must belong to the same team as the API key owner. Wins over email when both are provided.

Exemple:

"usr-15BB68317A7F06F0C07A3BBD8F244102A6872220"

string<email> | null

Optional. Email of a teammate whose queue config should be updated. Ignored when user_id is also supplied.

Exemple:

"[email protected]"

Réponse

Updated queue

data

object

A user's Power Dialer queue with its configuration and numbers.

Show child attributes

API

Webhooks

Conversations

Personnes

Entreprises

Deals

Notes

Fils de discussion

Numéros de téléphone

Réceptionniste IA

Tags

Modèles de résumé

Utilisateurs

SMS

Analytiques

Power Dialer

Partner

Cibler la file d’un coequipier

Autorisations

Corps

Réponse

​Cibler la file d’un coequipier

Autorisations

Corps

Réponse

Cibler la file d’un coequipier