API de Regi

Introducción

La API REST de Regi te permite operar WhatsApp Business desde tus propios sistemas (ERP, CRM, automatizaciones) sin usar el portal. La base de todos los llamados es:

https://api.regi.com.ar

Todas las respuestas son JSON. Los mensajes que envías por API aparecen también en la bandeja del portal, así tu equipo ve la conversación completa.

Autenticación

La API usa claves de tipo regi_live_… que pertenecen a tu cuenta. Se crean desde el portal en Administración → Claves de API (requiere rol administrador y plan Signal). La clave se muestra una única vez al crearla: guardala en un lugar seguro — Regi solo almacena una versión irrecuperable.

En cada request, mandala en el header Authorization:

Authorization: Bearer regi_live_TU_CLAVE

• No hace falta ningún otro header de identificación: la clave ya identifica a tu cuenta.
• Podés tener hasta 5 claves activas (una por sistema es una buena práctica).
• Revocar una clave desde el portal la desactiva de inmediato.
• Nunca publiques la clave en repositorios ni en código del lado del cliente (apps móviles, browsers).

Inicio rápido

Tres llamados y estás enviando: descubrí tu número, elegí un template aprobado y envialo.

export REGI_API_KEY='regi_live_TU_CLAVE'

curl "https://api.regi.com.ar/api/Phone?OnlyActive=true" \
  -H "Authorization: Bearer $REGI_API_KEY"

curl "https://api.regi.com.ar/api/Template?PageNumber=1&PageSize=20" \
  -H "Authorization: Bearer $REGI_API_KEY"

curl -X POST "https://api.regi.com.ar/api/Template/send" \
  -H "Authorization: Bearer $REGI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumberId":"<ID-DEL-PASO-1>","to":"549XXXXXXXXXX","templateName":"<NOMBRE-DEL-PASO-2>","languageCode":"es"}'

Si el template tiene variables {{n}} en el body, agregá components al envío — el ejemplo completo está en la referencia de abajo.

Tip: mientras desarrollás tu integración, usá tu propio número como destino. Los mensajes de prueba aparecen en la bandeja del portal como cualquier conversación, así verificás el circuito completo antes de apuntar a clientes reales.

Endpoints

curl "https://api.regi.com.ar/api/Phone?OnlyActive=true" \
  -H "Authorization: Bearer $REGI_API_KEY"

{
  "data": [
    {
      "id": "c5e8a2f1-3d4b-4e5f-8c9d-1a2b3c4d5e6f",
      "displayPhoneNumber": "+54 9 261 250-5882",
      "verifiedName": "Mi Empresa",
      "isActive": true,
      "wabaName": "Mi Empresa Argentina"
    }
  ],
  "success": true
}

curl "https://api.regi.com.ar/api/Template?PageNumber=1&PageSize=20" \
  -H "Authorization: Bearer $REGI_API_KEY"

{
  "data": {
    "items": [
      {
        "name": "cliente_bienvenida",
        "language": "es",
        "category": "UTILITY",
        "status": "APPROVED",
        "componentsJson": "[{\"type\":\"BODY\",\"text\":\"Hola {{1}}, tu expediente es {{2}}.\"}]"
      }
    ],
    "totalCount": 1
  },
  "success": true
}

curl -X POST "https://api.regi.com.ar/api/Template/send" \
  -H "Authorization: Bearer $REGI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumberId": "c5e8a2f1-3d4b-4e5f-8c9d-1a2b3c4d5e6f",
    "to": "5492611234567",
    "templateName": "cliente_bienvenida",
    "languageCode": "es",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Juan Pérez" },
          { "type": "text", "text": "PS-1234" }
        ]
      }
    ]
  }'

{
  "conversationId": "019defe0-0ea1-7001-9250-8ca635440a18",
  "messageId": "019f258c-4bb3-75a4-bc3e-0e5638a7b8a4",
  "metaMessageId": "wamid.HBgNNTQ5..."
}

Protección de costos

Cada template enviado se factura (Meta cobra por mensaje). Para evitar gastos por accidente — un retry de tu sistema, un loop — la API bloquea el envío de un template a un destinatario que ya recibió uno hace menos de 2 horas y todavía no respondió. En ese caso recibís un 400 con el detalle.

Si el reenvío es intencional, agregá "force": true al body del envío. La respuesta del cliente resetea la protección automáticamente.

Errores

Los códigos de error propios de WhatsApp (rechazos de Meta en el envío) están explicados en la guía de errores de WhatsApp.

Límites y consumo

• Rate limit: 60 requests por minuto por cuenta. Al superarlo recibís 429 con el header Retry-After.
• Segundos de API: el uso se mide en segundos de procesamiento. El plan Signal incluye 30.000 segundos por mes; el excedente se factura a US$ 0,001 por segundo al cierre del período. Un envío de template típico consume menos de un segundo.
• Monitoreo: el consumo del mes se ve en tiempo real en el portal, en Administración → Claves de API.
• Claves: hasta 5 activas por cuenta. Para rotar una clave, creá la nueva, actualizá tu sistema y revocá la anterior.