Contactos — etiquetas, notas y bulk

Además del CRUD básico, los contactos exponen operaciones para etiquetas, notas, recordatorios y acciones masivas. Todas cuelgan de /workspaces/:workspaceId/contacts.

Endpoints

Método	Ruta	Descripción
POST	/contacts/bulk	Crear contactos en lote
PATCH	/contacts/bulk-update	Actualizar en lote
DELETE	/contacts/bulk-delete	Eliminar en lote
POST	/contacts/import/check-duplicates	Verificar duplicados antes de importar
GET	/contacts/export	Exportar contactos
GET	/contacts/tags	Listar etiquetas del workspace
POST	/contacts/tags	Crear una etiqueta
POST	/contacts/:contactId/tags	Agregar etiquetas (por tagId) a un contacto
DELETE	/contacts/:contactId/tags/:tagId	Quitar una etiqueta de un contacto
GET	/contacts/:contactId/notes	Listar notas
POST	/contacts/:contactId/notes	Agregar una nota
PATCH	/contacts/:contactId/notes/:noteId	Editar una nota
DELETE	/contacts/:contactId/notes/:noteId	Eliminar una nota
GET	/contacts/:contactId/reminders	Listar recordatorios
POST	/contacts/:contactId/reminders	Crear un recordatorio
GET	/contacts/:contactId/activity	Línea de tiempo de actividad
GET	/contacts/:contactId/score	Score/temperatura del contacto
GET	/custom-properties	Listar propiedades personalizadas
POST	/custom-properties	Crear una propiedad personalizada

Ejemplo — agregar una nota

POST /workspaces/:workspaceId/contacts/:contactId/notes Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
content	string	Sí	Texto de la nota.

Consejo

Las notas son internas: el contacto nunca las ve. Sirven para dejar contexto a tu equipo — ver gestionar contactos.

Relacionado

• Crear contacto · Listar contactos

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/contacts/CONTACT_ID/notes" \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Pidió cotización del plan Pro." }'

Node

await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/contacts/CONTACT_ID/notes',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_API_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ content: 'Pidió cotización del plan Pro.' }),
  }
);

Python

import requests

requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/contacts/CONTACT_ID/notes",
    headers={"Authorization": "Bearer TU_API_KEY"},
    json={"content": "Pidió cotización del plan Pro."},
)

Respuesta 201

{
  "success": true,
  "data": {
    "id": "note_ab12cd34ef",
    "content": "Pidió cotización del plan Pro.",
    "createdAt": "2026-06-18T09:00:00.000Z"
  }
}