Para remoção em massa de tags de contatos via API no Cloud Chat, basta enviar uma requisição POST para:
https://cloudchat.cloudhumans.com/api/v1/accounts/ACCOUNT_ID/contacts/delete_tags
Certifique-se de enviar a chave de acesso (API_TOKEN) nos headers e os campos solicitados conforme descrito abaixo.
-
API_TOKEN: Token de acesso obtido nas configurações do perfil.
-
(https://cloudchat.cloudhumans.com/app/accounts/ACCOUNT_ID/profile/settings)
Requisição com campos de exemplo:
curl --request DELETE \
--url https://cloudchat.cloudhumans.com/api/v1/accounts/ACCOUNT_ID/contacts/delete_tags \
--header 'api_access_token: API_TOKEN \
--header 'content-type: application/json' \
--data '{
"contacts": [
{
"identifier": 123,
"tags": ["tag-de-massa-1","tag-de-massa-2"]
},
{
"email": "[email protected]",
"tags":
["tag-de-massa-2","tag-de-massa-3"]
},
{
"phone_number": 5551000000000,
"tags":
["tag-de-massa-1","tag-de-massa-3"]
}
]
}'
Corpo da Requisição:
O corpo da requisição deve conter um único campo, contacts, que deve ser um array de objetos.
Cada objeto representa um contato e deve conter os seguintes parâmetros:
-
identifier (opcional): Identificador único do contato.
-
email (opcional): E-mail do contato (no formato
[email protected]). -
phone_number (opcional): Número de telefone do contato (no formato
+550011112222). -
tags (obrigatório): Array com as tags a serem removidas (identificada pelo seu nome, como "tag-para-ser-removida").
Observação: Pelo menos um dos campos identifier, email ou phone_number deve ser informado para identificar o contato.
Exemplo de requisição:
{
"contacts": [
{
"identifier": 123,
"tags": ["tag-de-massa-1","tag-de-massa-2"]
}
]
}