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
read o full. Las altas, ediciones y bajas se hacen desde el panel o con una importación CSV.
Contactos
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 consentocontract.Límites: hasta 100.000 contactos y, además, los contactos incluidos en tu plan ( 409 contact_limital 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
subscribed | |
unsubscribed | |
bounced | |
complained | |
blocked |
Borrado por RGPD
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 vipomayorista.
Segmentos
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 anypudieran 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
read o full, las consultas son de solo lectura y siempre de tu organización, tanto con claves test como live:
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/contactsfiltra porq(texto),status,listIdytag. El detalle (GET /v1/contacts/{id}) añade campos propios, listas, etiquetas y estado de consentimiento, sin el historial completo.GET /v1/listsdevuelve las listas con su número de miembros.GET /v1/segmentsdevuelve 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.