Gestión de contactos
Importa, organiza y administra a las personas con las que hablan tus agentes y a las que llaman tus campañas.
Descripción general
Los contactos son las personas con las que hablan tus agentes. Quien llama o escribe a tus agentes se agrega solo; también puedes importar un archivo, agregar a alguien a mano o crear contactos por la API. Un número de teléfono pertenece a un solo contacto en un espacio de trabajo.
- Importaciones
- Archivos CSV o Excel, asignados columna por columna. Los archivos grandes se importan a una lista o a una campaña en segundo plano.
- Listas de contactos
- Grupos de contactos reutilizables a los que una campaña puede llamar.
- Filtros y vistas
- Encuentra personas por cualquier dato o campo, y guarda como vista los filtros que usas.
Campos del contacto
Cada contacto puede guardar la siguiente información:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
phone_number | string | Sí | Número internacional con el código de país, p. ej. +15551234567 (E.164). |
first_name | string | No | Nombre. |
last_name | string | No | Apellidos. |
display_name | string | No | Un nombre para mostrar en lugar del nombre y los apellidos. |
email | string | No | Correo electrónico. |
company | string | No | Nombre de la empresa u organización. |
notes | string | No | Notas internas. |
tags | array | No | Etiquetas para agrupar y filtrar. |
fields | object | No | Los campos propios de tu espacio de trabajo, por clave (abajo). |
Tus propios campos
Agrega los datos que necesita tu negocio, como interés, presupuesto o número de cuenta, en Configuración → Campos de contacto: campos de texto, número, fecha, opción, correo, teléfono o enlace, hasta 200 por espacio de trabajo. Al importar un archivo puedes crearlos a partir de sus columnas.
Los mensajes, las plantillas de WhatsApp y los pasos de campaña leen un campo como variable: {{contact.interest}} para un campo llamado Interest, con un texto de respaldo para cuando esté vacío, después de una barra: {{contact.interest | nuestros planes}}.
Importar contactos
Importa un archivo
Abre Contactos
Ve a Contactos en la barra lateral.
Elige el archivo
Haz clic en Importar y selecciona un archivo CSV o XLSX con una columna de números de teléfono.
Asigna las columnas
Elige qué es cada columna: un dato del contacto, un campo del contacto (uno existente o uno nuevo) o nada.
Importa
Revisa la vista previa y haz clic en Importar. Un contacto que ya existe recibe los valores que tiene tu archivo; las celdas vacías no cambian nada, y las filas duplicadas en el archivo se omiten.
name,phone,email,company,tags,interest John Smith,+15551234567,john@example.com,Acme Corp,"lead,enterprise",Pro plan Jane Doe,+15559876543,jane@example.com,TechStart,"lead,startup",Starter plan Bob Wilson,+15555555555,bob@example.com,BigCo,"customer,vip",Renewal
Crea contactos por la API
Agrega contactos desde tu propio código con una clave de API que tenga el permiso contacts:write. El número debe incluir su código de país:
curl -X POST https://www.nutalk.ai/v1/contacts \
-H "Authorization: Bearer $NUTALK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+14155551234",
"first_name": "Jane",
"last_name": "Smith",
"email": "jane@example.com",
"company": "Tech Startup",
"tags": [
"prospect",
"inbound"
],
"fields": {
"interes": "Departamento"
}
}'Listas de contactos
Una lista es un grupo de personas a las que una campaña llama o escribe, como leads empresariales, usuarios en periodo de prueba, clientes que se fueron o cuentas VIP. Un contacto puede estar en varias listas.
Crea la lista
Abre Campañas → Listas de contactos y haz clic en Nueva lista.
Ponle nombre
Dale un nombre y, si quieres, una descripción.
Agrega personas
En Contactos, filtra y selecciona personas y elige Agregar a lista; o importa un archivo a la lista; o agrega personas una por una.
Vincula una lista a una campaña en Configuración → General de la campaña: sus miembros quedan inscritos, y también las personas que agregues después a la lista. Se omiten los miembros marcados como no contactar.
Encontrar contactos
Búsqueda
El cuadro de búsqueda encuentra contactos por nombre, número de teléfono o correo.
Filtros
Arriba de la tabla están los filtros rápidos de lista, etiqueta, canal y último contacto, y Filtro agrega cualquier otro dato o campo:
| Filtro | Ejemplo |
|---|---|
| Etiqueta | tiene alguna de “enterprise” |
| Agregado | en los últimos 30 días |
| Origen | es HubSpot |
| Campaña | no está en ninguna campaña |
| Último contacto | nunca |
Guarda como vista los filtros y las columnas que usas seguido.
Administrar contactos
- Editar contactos
- Abre un contacto para cambiar sus datos y campos. Un campo se guarda cuando presionas Enter o sales de él.
- Acciones en lote
- Selecciona contactos para agregarlos a una lista o a una campaña, agregar o quitar etiquetas, exportarlos como CSV o eliminarlos.
- Duplicados
- Un número de teléfono pertenece a un solo contacto, así que una llamada o una importación desde un número conocido llega al mismo contacto.
- Eliminar contactos
- Elimina un contacto o varios. Los contactos con llamadas, chats, citas o campañas se conservan para que su historial quede completo; los demás se eliminan para siempre.
Cuando alguien en una llamada de campaña pide que no lo vuelvan a llamar, la IA lo detecta después, al leer la llamada: el intento termina, el contacto queda marcado como no contactar y sus intentos pendientes se detienen en todas las campañas. Las llamadas hechas a mano o por la API, y las que la IA no puede leer, no marcan a nadie, así que marca tú a esas personas: el interruptor Llamadas y mensajes de campañas en la página del contacto desactiva las campañas para esa persona, y puedes volver a activarlo después. Para marcar muchos números a la vez, súbelos en Contactos → Más → Lista de no llamar.
Integraciones con CRM
Trae leads de tu CRM y registra el resultado de cada llamada con los pasos de CRM de la campaña:
Referencia de la API
Administra contactos desde tu propio código con la API de contactos:
| Endpoint | Qué hace |
|---|---|
GET /v1/contacts | Lista los contactos, con búsqueda y filtros por etiqueta |
POST /v1/contacts | Crea un contacto |
GET /v1/contacts/:id | Obtiene un contacto |
PATCH /v1/contacts/:id | Actualiza un contacto |
DELETE /v1/contacts/:id | Elimina un contacto |
Los campos, las listas, las importaciones grandes y la lista de no llamar tienen sus propios endpoints, documentados en inglés: Listas de contactos, Importaciones de contactos y POST /v1/exclusions.
Buenas prácticas
- Escribe los números con el código de país
- Usa E.164 (+ y el código de país, como +15551234567). NuTalk normaliza lo que puede y rechaza los números que no puede leer; la API nunca adivina un país.
- Usa las etiquetas con estrategia
- Mantén un esquema de etiquetas coherente. Usa etiquetas para el estado del lead, el origen, la industria o cualquier cosa por la que quieras filtrar.
- Mantén limpios tus datos
- Quita los números desconectados y los que nunca conectan, para que tus campañas llamen a personas que pueden contestar.
- Usa tus campos
- Guarda en campos del contacto lo que necesitan tus mensajes y los pasos de tus campañas, e insértalos como variables para personalizar cada conversación.