Base URL https://api.afer.pro Referencia aferapp.com Reservar demo

Anotar en una oportunidad

POST https://api.afer.pro/api/v1/crm/opportunities/{id}/notes
Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/api/v1/crm/opportunities/{id}/notes

Apunta lo que ha pasado en una oportunidad y, si se sabe, deja planificado el siguiente paso.

Es «Registrar acción» de la ficha del CRM, hecho desde fuera: una anotación en el timeline de la oportunidad (una llamada, un WhatsApp, una reunión, una nota) y, opcionalmente, una tarea en el calendario con la fecha del siguiente paso. Cuando se planifica un siguiente paso, la oportunidad actualiza su «próxima acción» igual que lo hace la pantalla.

A diferencia de la ficha, el siguiente paso no es obligatorio: si no se envía siguiente, la nota se guarda sin él. Está pensado para que un asistente pueda apuntar lo que le dicen sin convertir cada nota en un interrogatorio.

La oportunidad se identifica con el oportunidadId que devuelve buscarOportunidad (o consultarOportunidades); también se acepta el numérico legacy.

Autenticación

Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →

Este endpoint requiere autenticación con API key: sin credenciales responde 401.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

oportunidadIdstring|int
obligatorio
La oportunidad (en la ruta, {id}): id cifrado o numérico legacy. Debe pertenecer a tu cuenta.
notastring
obligatorio
Qué ha pasado. Obligatoria salvo que se envíe siguiente.
mediostring
opcional
Por dónde ha sido: llamada, whatsapp, email, reunion, visita, sms o nota (por defecto). Decide el tipo de anotación del timeline.
fechadate
opcional
Cuándo pasó (YYYY-MM-DD). Por defecto, ahora. Una fecha futura se sustituye por ahora.
horastring
opcional
A qué hora pasó (HH:MM).
siguienteobject
opcional
El siguiente paso: fecha (YYYY-MM-DD, obligatoria), hora (HH:MM), medio (llamada, whatsapp, email, reunion, visita, sms, tarea) y descripcion. Sin descripción se pone el medio y el título de la oportunidad.

Ejemplo de petición

curl -X POST 'https://api.afer.pro/api/v1/crm/opportunities/aBc123XyZ/notes' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET' \
  -H 'Content-Type: application/json' \
  -d '{
    "nota": "WhatsApp de Aina: se disculpa por no contestar ayer. La propuesta va por buen camino.",
    "medio": "whatsapp",
    "siguiente": {
        "fecha": "2026-10-22",
        "medio": "llamada"
    }
}'
<?php

$data = [
  'nota' => 'WhatsApp de Aina: se disculpa por no contestar ayer. La propuesta va por buen camino.',
  'medio' => 'whatsapp',
  'siguiente' => [
    'fecha' => '2026-10-22',
    'medio' => 'llamada',
  ],
];

$ch = curl_init('https://api.afer.pro/api/v1/crm/opportunities/aBc123XyZ/notes');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: afer_tk_TU_TOKEN',
    'X-API-SECRET: afer_sk_TU_SECRET',
    'Content-Type: application/json',
]);

$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);
const respuesta = await fetch('https://api.afer.pro/api/v1/crm/opportunities/aBc123XyZ/notes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  },
  body: JSON.stringify({
      "nota": "WhatsApp de Aina: se disculpa por no contestar ayer. La propuesta va por buen camino.",
      "medio": "whatsapp",
      "siguiente": {
          "fecha": "2026-10-22",
          "medio": "llamada"
      }
  })
});

const resultado = await respuesta.json();

Respuesta

200 · application/json
{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "oportunidadId": "aBc123XyZ…",
        "nombre": "MIXING MEDIA SL",
        "titulo": "Consultoría IA",
        "notaId": "dEf456…",
        "fecha": "2026-10-16 20:21:00",
        "medio": "whatsapp",
        "siguiente": {
            "tareaId": "gHi789…",
            "fecha": "2026-10-22",
            "hora": "",
            "medio": "llamada",
            "descripcion": "Llamar · Consultoría IA"
        },
        "proxima_accion": {
            "texto": "Llamar · Consultoría IA",
            "fecha": "2026-10-22 00:00",
            "medio": "llamada"
        },
        "anotaciones": 4
    }
}

Errores

CasoResultado
Sin credenciales de API key errorCode 401.
oportunidadId ausente o inválido; ni nota ni siguiente; siguiente.fecha sin formato YYYY-MM-DD errorCode 400.
La oportunidad no existe o no es de tu cuenta errorCode 404.
Notas
  • La anotación queda a nombre de la persona dueña de la API key, como en la ficha.
  • La tarea del siguiente paso se asigna a quien lleva la oportunidad; si no tiene nadie asignado, a la persona de la API key.
  • Acepta la cabecera X-IDEMPOTENCY-KEY contra dobles envíos: sin ella, cada llamada crea una anotación nueva.