Normalização por tipo

Você pode enviar o valor como o cliente digitou — máscara, @, maiúsculas. A API normaliza antes de comparar e deduplicar.

Em poucas palavras

Cada type tem regras simples de formatação.
Comparações, busca e remoção usam sempre o valor normalizado.
A API não cria contato sozinha — só associa contactId se o contato já existir no workspace.

Tipo	O que você envia	Como fica salvo	Canais bloqueados
`email`	`User@Example.com`	minúsculas, formato válido	E-mail
`phone`	`+55 (11) 99999-0000`	E.164 (`+5511999990000`)	SMS, WhatsApp, RCS, voz
`telegram`	`@usuario` ou ID numérico	username sem `@` ou peer	Telegram
`instagram`	`@Perfil`	username minúsculo sem `@`	Instagram

Analogia: é como padronizar telefone antes de colocar na agenda — (11) 99999-0000 e 5511999990000 viram a mesma entrada.

Use channel para documentar em qual contexto a supressão foi criada (ex.: whatsapp, email). A regra global por identidade continua valendo:

Telefone bloqueia todos os canais de telefone, independente do channel informado.
E-mail bloqueia só e-mail.

Entrada:

{ "type": "phone", "value": "(11) 98888-7777" }

Salvo como E.164. Bloqueia SMS, WhatsApp, RCS e voz para esse número.

Entrada:

{ "type": "email", "value": "Cliente@Empresa.com.br" }

Salvo como cliente@empresa.com.br.

Entrada:

{ "type": "telegram", "value": "@MeuBot" }

Salvo como meubot (username) ou peer numérico, conforme o valor.

Se o valor não passar na normalização do tipo, a API responde 400 com INVALID_SUPPRESSION_VALUE. Veja Troubleshooting.