Neste artigo, você vai aprender a remover tags de múltiplos contatos de uma só vez no Cloud Chat via API.
Para remoção em massa de tags de contatos via API no Cloud Chat, basta enviar uma requisição DELETE 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"]
}
]
}
Como o contato é localizado
O sistema busca o contato nesta ordem:
identifier(primeiro)email(segundo)phone_number(terceiro)
Diferente do endpoint de import de contato, aqui o identifier tem prioridade sobre email.
Nota sobre phone_number: Se enviado sem o prefixo
+, o sistema adiciona automaticamente (ex:5511999998888vira+5511999998888).