Contatos: filtros, labels, merge e contact inboxes

A API de contatos tambem cobre filtros, etiquetas, mesclagem e relacao entre contato e caixa de entrada.

Filtros de contato

Use /contacts/filter para consultas estruturadas quando a busca simples nao for suficiente. Exemplos: contatos por atributo, canal, data ou estado de cadastro.

Etiquetas do contato

curl -X POST "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts/123/labels" \
  -H "api_access_token: $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"labels":["cliente-premium", "api"]}'

A atualizacao de labels pode substituir a lista existente. Leia a resposta e preserve etiquetas que nao devem ser removidas.

Contactable inboxes

Use /contacts/:id/contactable_inboxes para descobrir em quais caixas o contato pode ser acionado.

curl -X GET "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts/123/contactable_inboxes" \
  -H "api_access_token: $API_TOKEN"

Contact inbox

Use /contacts/:id/contact_inboxes para criar vinculo entre contato e inbox quando o fluxo exigir e o usuario tiver permissao.

Merge

Use merge apenas quando tiver certeza de que dois contatos representam a mesma pessoa. Depois da mesclagem, o contato secundario e removido.

Cuidados

Mesclagem e etiquetas afetam a operacao do atendimento. Registre quem fez a alteracao, IDs envolvidos e motivo.