Cómo convertir una conversación de WhatsApp en una tarea de WACRM

En WACRM, una tarea siempre empieza desde una conversación: un cliente pregunta algo que tu equipo necesita seguir, y en vez de anotarlo mentalmente la conviertes en una tarea ahí mismo, en el Inbox. Este tutorial cubre lo que esa pantalla hace hoy en realidad, cómo hacer lo mismo (más la asignación) por la API, y dónde el puente hacia el sistema Work de WACRM todavía necesita pedírselo a WACRM en lugar de activarlo tú mismo.

Qué necesitas antes de empezar

• Una cuenta de WACRM Workspace con al menos un proyecto y al menos una conversación en Conversations → Inbox.
• Solo para los pasos de la API: curl (o cualquier cliente HTTP que pueda poner un encabezado), y una clave de API desde Developer / API & MCP.

Crea una tarea desde el Inbox

1. Abre Conversations → Inbox y selecciona la conversación que quieres seguir.
2. En el panel lateral, busca la tarjeta Tasks, debajo de la tarjeta Contact de la conversación (y debajo de las tarjetas Consent y Billing también, cuando aparecen para ese contacto). Empieza vacía, mostrando No tasks yet, hasta que creas la primera.
3. Haz clic en Create task. Se abre un cuadro de diálogo que pide un Title (obligatorio) y una Due date (opcional).
4. Escribe un título y haz clic en Create task dentro del cuadro de diálogo.

El cuadro se cierra y la tarea nueva aparece de inmediato arriba de la lista — la tarjeta vuelve a cargar justo después de crear algo, así que no hay nada que refrescar a mano. Cada fila muestra el título de la tarea, un chip de estado y cuándo se creó. Una tarea nueva siempre empieza con estado open (chip en color de advertencia); done se muestra en verde, cancelled en gris neutro.

No hay ningún campo de nota o descripción aquí — solo se guardan título y fecha límite, porque eso es todo lo que envía hoy este cuadro de diálogo. Tampoco hay un selector de persona asignada en esta pantalla; la asignación solo es posible por la API, como se ve abajo.

Crea y lista tareas por la API

Todo lo que hace la tarjeta Tasks está respaldado por dos endpoints de la Core API, con alcance por conversación:

POST /v1/conversations/{conversation}/tasks      work:write
GET  /v1/conversations/{conversation}/tasks       work:read

work:read/work:write se pueden seleccionar al crear una clave — en Developer / API & MCP, haz clic en Create key, abre Restrict what this key can do (advanced) y marca work:read/work:write dentro de WhatsApp CRM scopes (work:write necesita una Secret key). Crear claves y restringir scopes depende de tu plan — Workspace muestra un aviso de actualización si el tuyo no lo incluye. Una clave creada sin ellos responde 403 insufficient_scope en estas llamadas — es lo esperado, no un error; crea una nueva clave con los scopes marcados.

Crea una tarea, con asignación

POST .../tasks requiere un encabezado Idempotency-Key, la misma convención que POST /v1/messages: repetir la misma solicitud con la misma clave reproduce la tarea original en vez de crear una segunda, lo que hace seguro reintentar después de un timeout.

curl -s -X POST "https://api.wacrm.ai/v1/conversations/your-conversation-uuid/tasks" \
  -H "Authorization: Bearer sk_live_your_scoped_key" \
  -H "Idempotency-Key: a-key-you-generate-once-per-task" \
  -H "Content-Type: application/json" \
  -d '{"title": "Llamar por el reembolso", "due_at": "2026-11-10", "assignee_ref": "staff-jane"}'

{
  "data": {
    "id": "0e2b1c9a-...-task-uuid",
    "conversation_id": "your-conversation-uuid",
    "title": "Llamar por el reembolso",
    "due_at": "2026-11-10T00:00:00+00:00",
    "assignee_ref": "staff-jane",
    "status": "open",
    "external_ref": null,
    "created_at": "2026-11-06T09:00:00+00:00"
  }
}

due_at y assignee_ref son opcionales. assignee_ref es un texto libre que define tu propio sistema — WACRM no lo valida contra ninguna lista de personal, porque Workspace todavía no tiene un concepto propio de asignación de personal del que esta pantalla pueda tomarlo. external_ref queda en null hasta que el puente Work entregue la tarea al otro lado.

Lista las tareas de una conversación

curl -s "https://api.wacrm.ai/v1/conversations/your-conversation-uuid/tasks" \
  -H "Authorization: Bearer sk_live_your_scoped_key"

Es la misma llamada que hace la propia tarjeta Tasks del Inbox, así que la respuesta siempre coincide con lo que verías en pantalla — las más nuevas primero, con los mismos campos que la respuesta de creación de arriba (8 campos cada una).

Mira cómo vuelve el estado de una tarea

Una vez que una tarea llega al lado de Work, un cambio de estado ahí (alguien la marca como hecha, o la cancela) debería volver a WACRM mediante una llamada firmada, POST /v1/work/callbacks, y actualizar el status de la tarea a done o cancelled. Desde el Inbox, eso se ve como un cambio de color en el chip de la tarea la próxima vez que abres la conversación de nuevo — esta tarjeta no hace sondeo en vivo ni vuelve a cargar solo por mirar la misma conversación otra vez, así que un cambio de estado hecho mientras ya la estás mirando no aparecerá hasta que cambies a otra conversación y vuelvas.

Dos cosas tienen que ser ciertas del lado de WACRM para que ese viaje de ida y vuelta realmente ocurra, y ninguna la puedes activar tú mismo desde Workspace:

• El puente Work tiene que estar activado. WACRM lo activa para todo el servicio, no por workspace, y hoy está apagado; un puente desactivado igual guarda tu tarea y encola su entrega, solo que nunca llega al otro lado ni obtiene un external_ref hasta que WACRM lo active.
• El lado de Work tiene que enviar el webhook de estado. Hoy, el status de una tarea solo cambia por esa llamada — no hay ningún sondeo de respaldo del lado de WACRM. Si una tarea que creaste parece estancada en open aunque se haya gestionado en otro lado, ese es el límite conocido, no algo que te falte en Workspace.

Qué funciona hoy y qué necesita a WACRM

¿Listo para ponerlo en práctica? Solicita acceso anticipado para tener un Workspace, o deja que el equipo de WACRM configure tu proyecto con Quick Setup.