Contactos

Los contactos son la base de tu sistema de comunicaciones en SendMe123. A través de estos endpoints puedes crear, consultar, actualizar y eliminar contactos de manera eficiente.

Endpoints disponibles

Los endpoints de contactos te permiten gestionar toda tu base de datos de contactos.

Método	Endpoint	Descripción
GET	`/api/contacts`	Obtener lista paginada de contactos
POST	`/api/contacts`	Crear un nuevo contacto
GET	`/api/contacts/{id}`	Obtener contacto por ID
PATCH	`/api/contacts/{id}`	Actualizar contacto existente
DELETE	`/api/contacts/{id}`	Eliminar contacto específico

Comenzar

Explora los endpoints disponibles:

Obtener Contacto por ID

Consulta los detalles de un contacto específico usando su ID único.

Ver documentación →

Actualizar Contacto

Modifica la información de un contacto existente.

Ver documentación →

Eliminar Contacto

Elimina un contacto de manera permanente de tu base de datos.

Ver documentación →

Información general

Campos de contacto

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre del contacto
`phone`	string	Sí	Número de teléfono (sin prefijo)
`lastName`	string	No	Apellido del contacto
`email`	string	No	Dirección de correo electrónico
`countryCode`	string	No	Código de país (ej: “57”)
`status`	enum	No	Estado: `ACTIVE`, `INACTIVE`, `BLOCKED`
`birthDate`	datetime	No	Fecha de nacimiento
`tagIds`	array	No	IDs de etiquetas asociadas
`customValues`	object	No	Campos personalizados

Estados de contacto

Estado	Descripción
`ACTIVE`	Contacto activo (puede recibir mensajes)
`INACTIVE`	Contacto inactivo (pausado temporalmente)
`BLOCKED`	Contacto bloqueado (no puede recibir mensajes)

Validaciones

Teléfono: Debe ser un número válido de 10 dígitos
Email: Debe tener formato válido si se proporciona
Nombre: Mínimo 2 caracteres, máximo 100
countryCode: Debe ser un código numérico válido