Skip to content

Actividades

Endpoints para registro de interacciones y actividades con clientes.

Registrar Actividad de Cliente

POST /api/activities

Crea una nueva actividad (ej: interacción por email, SMS o WhatsApp) para un cliente y actualiza su información de último contacto.

Casos de uso:

  • Registrar seguimiento después de feedback negativo
  • Documentar comunicaciones de campaña
  • Mantener historial de interacciones con cliente

Cuerpo de la Solicitud

json
{
  "client_id": "ef9fa264-3850-4bd2-875e-2b40a4dd432f",
  "name": "Envío de mensaje de bienvenida",
  "description": "Se envió un WhatsApp con información del programa de fidelidad",
  "type": "whatsapp"
}
CampoTipoObligatorioDescripción
client_idstringID del cliente (formato UUID)
namestringNombre de la actividad (3-250 caracteres)
descriptionstringDescripción de la actividad (3-250 caracteres)
typestringTipo de actividad: whatsapp, email o sms

Tipos de Actividad

TipoDescripción
whatsappMensaje vía WhatsApp
emailEmail enviado
smsSMS enviado

Ejemplo de Solicitud

bash
curl -X POST "https://api-b2s.experienciab2s.com/api/activities" \
     -H "Authorization: Bearer SU_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "client_id": "ef9fa264-3850-4bd2-875e-2b40a4dd432f",
       "name": "Envío de mensaje de bienvenida",
       "description": "Se envió un WhatsApp con información del programa de fidelidad",
       "type": "whatsapp"
     }'

Respuesta Exitosa (201)

json
{
  "message": "Activity created with success"
}

Códigos de Respuesta

CódigoDescripción
201Actividad creada exitosamente
400Error de validación
403Token inválido o usuario no autorizado
404Token o cliente no encontrado

Integration Documentation