Sendme API Documentation

Funcionalidades principales

Autenticación por API Key

Sistema de autenticación simple y seguro mediante API keys para proteger todos los endpoints.

Gestión de Contactos

Crea y administra contactos con información detallada para tus comunicaciones.

Envío de SMS

Envía mensajes SMS de manera programática con confirmación de entrega.

Envío de Emails

Envía emails personalizados con soporte para HTML y texto plano.

Endpoints disponibles

Autenticación

Aprende cómo autenticarte usando API Keys o JWT tokens. Ver documentación →

Contactos

CRUD completo para gestionar contactos con filtros avanzados y paginación. Ver documentación →

Mensajes

Envía SMS y emails, consulta historial y gestiona comunicaciones masivas. Ver documentación →

Empezar ahora

Para comenzar a usar la API de Sendme:

1. Obtén tu API Key: Regístrate en app.sendme123.com para obtener tus credenciales de acceso
2. Crea contactos: Registra los destinatarios de tus comunicaciones
3. Envía mensajes: Utiliza los endpoints de SMS o email para comunicarte

Casos de uso populares

Integración básica

// Crear contacto y enviar SMS de bienvenida
const crearContactoYEnviarSMS = async () => {
  try {
    const contacto = await axios.post('https://app.sendme123.com/api/contacts', {
      name: 'Juan Pérez',
      phone: '3001234567'
    }, {
      headers: { 'api-key': 'tu-api-key', 'Content-Type': 'application/json' }
    });

    await axios.post('https://app.sendme123.com/api/messages/send/sms', {
      type: 'sms',
      contacts: ['3001234567'],
      message: 'Bienvenido a nuestra plataforma!',
      countryCode: '57'
    }, {
      headers: { 'api-key': 'tu-api-key', 'Content-Type': 'application/json' }
    });

    console.log('Contacto creado y SMS enviado');
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

Comunicación masiva

// Enviar email a todos los contactos activos
const enviarEmailMasivo = async () => {
  try {
    await axios.post('https://app.sendme123.com/api/messages/send/email', {
      subject: 'Actualización importante',
      message: 'Contenido del email...',
      contacts: ['[email protected]', '[email protected]']
    }, {
      headers: { 'api-key': 'tu-api-key', 'Content-Type': 'application/json' }
    });

    console.log('Email masivo enviado');
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};