En resumen
- Cada
typetiene reglas simples de formato. - Comparaciones, búsqueda y eliminación usan siempre el valor normalizado.
- La API no crea contacto sola — solo asocia
contactIdsi el contacto ya existe en el workspace.
Reglas por tipo
Analogía: es como estandarizar el teléfono antes de ponerlo en la agenda —
(11) 99999-0000 y 5511999990000 se convierten en la misma entrada.
Campo channel (opcional)
Use channel para documentar en qué contexto se creó la supresión (ej.: whatsapp, email). La regla global por identidad sigue vigente:
- Teléfono bloquea todos los canales de teléfono, independientemente del
channelinformado. - Email bloquea solo email.
Ejemplos en la práctica
Teléfono con máscara
Entrada:Email con mayúsculas
Entrada:cliente@empresa.com.br.
Telegram con @
Entrada:meubot (username) o peer numérico, según el valor.
Valor inválido
Si el valor no pasa la normalización del tipo, la API responde 400 conINVALID_SUPPRESSION_VALUE. Vea Troubleshooting.
Próximos pasos
- Inicio rápido: agregar por API
- Introducción: cuándo usar supresión

