Foccuz Integration API
  1. activities
Foccuz Integration API
  • API externa
    • Comenzando con Foccuz Integration API
    • Autenticación vía API Key
    • Límite de uso (Rate Limiting) y Restricciones de tamaño (Body Size Limiting)
    • Colaboradores con Compensaciones Variables (Usuario/Colaborador)
    • Empresas (Clientes/Cuentas/Compañías)
    • Negocio (Operación, Venta, Cobranza, Acción clave)
    • Actividad (Acción, Productividad, Indicador)
    • Campos personalizados
    • Orden de ejecucción
    • Consideraciones
    • Flujos de ejemplo
    • Manejo de errores
    • v2
      • integration
        • deals
          • /v2/integration/deals
          • /v2/integration/deals
        • activities
          • /v2/integration/activities
            POST
          • /v2/integration/activities
            PATCH
        • account
          • /v2/integration/account
          • /v2/integration/account
        • sales-profile
          • /v2/integration/sales-profile
          • /v2/integration/sales-profile
  • Integraciones
    • Buk
      • Conectarse con Buk
  1. activities

/v2/integration/activities

POST
/v2/integration/activities

Solicitud

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200OK
application/json
Body

🟠400Solicitud Incorrecta
🟠401No Autorizado
🟠404Registro No Encontrado
🔴500Error del Servidor
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/integration/activities' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "batchId": "deal-batch-2025-08-26-001",
    "source": "crm-system-x",
    "items": [
        {
            "externalId": "A-1001",
            "type": "CALL",
            "ownerExternalId": "U-77",
            "source": {
                "name": "OUTBOUND"
            },
            "associated": {
                "accountExternalId": "ACC-001",
                "dealExternalId": "D-1001"
            },
            "customFields": [
                {
                    "key": "duration",
                    "type": "number",
                    "value": 30,
                    "name": "Duration"
                },
                {
                    "key": "follow_up",
                    "type": "boolean",
                    "value": true,
                    "name": "Follow Up"
                }
            ]
        },
        {
            "externalId": "A-1002",
            "type": "EMAIL",
            "ownerExternalId": "U-88",
            "source": {
                "name": "INBOUND"
            },
            "associated": {
                "accountExternalId": "ACC-002"
            }
        },
        {
            "externalId": "A-1003",
            "type": "MEET",
            "ownerExternalId": "U-77",
            "source": {
                "name": "OUTBOUND"
            }
        }
    ]
}'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "data": {
        "code": 201,
        "success": 100,
        "error": [
            {
                "message": "VALIDATION_ERROR",
                "detail": "Invalid currency code (ISO-4217)"
            }
        ]
    },
    "status": "SUCCESS"
}
Modificado en 2025-09-11 19:51:01
Anterior
/v2/integration/deals
Siguiente
/v2/integration/activities
Built with