Saltar al contenido

Contactos, listas y segmentos

Gestiona tus contactos con consentimiento, organízalos en listas y etiquetas, define segmentos sencillos y consúltalos por API con una clave de solo lectura.

Por Equipo Vemudo · Actualizado el

Los contactos son las personas a las que envías campañas. Se gestionan en el panel y se pueden consultar por API con una clave read o full. Las altas, ediciones y bajas se hacen desde el panel o con una importación CSV.

Contactos

Un contacto tiene su email, nombre y apellidos opcionales, campos propios, etiquetas, pertenencia a listas y una historia de consentimiento.

  • Al dar de alta un contacto a mano, declaras que tienes su permiso y de dónde viene: formulario web, clientes, en persona u otro (con un texto de 3 a 200 caracteres). Vemudo lo guarda con la fecha y no lo puede modificar nadie después, para que puedas demostrarlo.
  • La base legal puede ser consent o contract.
  • Límites: hasta 100.000 contactos y, además, los contactos incluidos en tu plan (409 contact_limit al superarlos). Bajar de plan no borra nada.
  • Hasta 50 campos propios y 200 etiquetas por organización. Las etiquetas se crean al usarlas y tienen de 1 a 40 caracteres.
  • Las acciones en lote (añadir a una lista, etiquetar, dar de baja, borrar) admiten de 1 a 500 contactos.

Estado de un contacto

EstadoSignificado
subscribedRecibe campañas.
unsubscribedSe dio de baja. Gana a cualquier otro estado.
bouncedSu dirección rebotó o está bloqueada por rebotes.
complainedMarcó un email como spam.
blockedLa dirección está en la lista de bajas y bloqueos.

Dar de baja un contacto no lo añade a la lista de bloqueos transaccional: tus emails de pedido siguen llegando, tus campañas no.

Borrado por RGPD

Los propietarios y administradores pueden borrar un contacto (o varios) de forma definitiva: se eliminan sus datos, sus listas y su historial de consentimiento. La dirección queda marcada como borrada y no se puede volver a dar de alta (409 contact_erased). Las supresiones existentes se conservan para no volver a escribirle.

Listas y etiquetas

  • Una lista es un grupo con nombre (clientes, suscriptores, mayoristas). Hasta 100 por organización, con nombre único.
  • Un contacto puede estar en varias listas. Si una persona rechaza una lista concreta en su página de preferencias, las importaciones no la vuelven a añadir a ella.
  • Las etiquetas son marcas libres para filtrar, por ejemplo vip o mayorista.

Segmentos

Un segmento es un público que se calcula al momento a partir de reglas sencillas. No hay fórmulas:

  • Combina de 1 a 10 reglas con todas (all) o cualquiera (any).
  • Se puede filtrar por email, nombre, fecha de alta, lista, etiqueta, origen del permiso y por tus campos propios, con operadores según el tipo (contiene, es, empieza por, antes de, en los últimos N días...).
  • Un segmento solo incluye contactos suscritos y sin bloqueo activo, aunque las reglas con any pudieran incluirlos.
  • Puedes previsualizar el recuento antes de guardar. Hasta 100 segmentos activos por organización con nombre único.
  • Si borras una lista que usa un segmento, el segmento queda marcado como no válido hasta que lo repares, sin romper el resto.

Consultar por API

Con scope read o full, las consultas son de solo lectura y siempre de tu organización, tanto con claves test como live:

bash
curl "https://api.vemudo.com/v1/contacts?status=subscribed&listId=$LIST_ID&limit=50" \
  -H "Authorization: Bearer $VEMUDO_API_KEY"

curl https://api.vemudo.com/v1/lists -H "Authorization: Bearer $VEMUDO_API_KEY"
curl https://api.vemudo.com/v1/segments -H "Authorization: Bearer $VEMUDO_API_KEY"
  • GET /v1/contacts filtra por q (texto), status, listId y tag. El detalle (GET /v1/contacts/{id}) añade campos propios, listas, etiquetas y estado de consentimiento, sin el historial completo.
  • GET /v1/lists devuelve las listas con su número de miembros.
  • GET /v1/segments devuelve los segmentos con su definición.
  • Los listados usan paginación por cursor; ver Consultar la cuenta y estadísticas.
  • Un id de otra organización o mal formado devuelve 404 not_found, igual que uno que no existe.