curl --request POST \
  --url https://api.zappfy.io/chat/labels \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "number": "5511999999999",
  "labelids": [
    "10",
    "20",
    "30"
  ]
}
'

{
  "response": "Labels updated successfully",
  "editions": [
    "Added label 10 to chat",
    "Added label 20 to chat",
    "Removed label 5 from chat"
  ]
}

Etiquetas

Gerencia labels de um chat

Atualiza as labels associadas a um chat específico. Este endpoint oferece três modos de operação:

Definir todas as labels (labelids): Define o conjunto completo de labels para o chat, substituindo labels existentes
Adicionar uma label (add_labelid): Adiciona uma única label ao chat sem afetar as existentes
Remover uma label (remove_labelid): Remove uma única label do chat sem afetar as outras

Importante: Use apenas um dos três parâmetros por requisição. Labels inexistentes serão rejeitadas.

As labels devem ser fornecidas no formato id ou labelid encontradas na função get labels.

POST

chat

labels

curl --request POST \
  --url https://api.zappfy.io/chat/labels \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data '
{
  "number": "5511999999999",
  "labelids": [
    "10",
    "20",
    "30"
  ]
}
'

{
  "response": "Labels updated successfully",
  "editions": [
    "Added label 10 to chat",
    "Added label 20 to chat",
    "Removed label 5 from chat"
  ]
}

Autorizações

token

string

header

obrigatório

Corpo

application/json

Option 1
Option 2
Option 3

number

string

obrigatório

Número do chat ou grupo

Exemplo:

"5511999999999"

labelids

string[]

obrigatório

Lista de IDs das labels a serem aplicadas ao chat (define todas as labels)

Exemplo:

["10", "20"]

add_labelid

string

ID da label a ser adicionada ao chat

Exemplo:

"10"

remove_labelid

string

ID da label a ser removida do chat

Exemplo:

"20"

Resposta

Labels atualizadas com sucesso

response

string

Mensagem de confirmação

editions

string[]

Lista de operações realizadas (apenas para operação labelids)

Lista contatos bloqueados Editar etiqueta