Todos los temas
Español

Bandejas · 4 min de lectura

Crea una bandeja API para una integración

Prepara un canal para un portal o aplicación y distingue registro, webhook y clasificación SMS.

En esta guía
  1. Cuándo usar una bandeja API
  2. Registra la bandeja API
  3. Comprende el webhook y ambos sentidos
  4. Utiliza clasificación SMS solo cuando corresponda
  5. Valida antes de habilitar la integración
  6. Guías relacionadas

Para propietarios y administradores de agencias Insurance.

Cuándo usar una bandeja API

Usa API cuando un portal, aplicación o canal propio necesita intercambiar mensajes con el equipo en Conversaciones. Por ejemplo, un portal envía una consulta de documentos y recibe la respuesta del agente. La bandeja organiza; la comunicación requiere una integración implementada.

Asigna responsable técnico para mensajes de entrada y respuestas. Define nombre, agencia, identificación de remitentes y destino de eventos. Este canal no instala chat listo, conecta número ni crea credenciales automáticamente. Para WhatsApp o SMS nativos utiliza su flujo específico.

Registra la bandeja API

  1. Abre Administración → Configuración → Canales → Bandejas → Nueva bandeja → API.
  2. Ingresa un nombre como Portal · Solicitudes.
  3. En Webhook de entrada (opcional), utiliza solo la URL indicada por el técnico. El ejemplo es ficticio y no debe copiarse.
  4. Deja Usar como SMS desmarcado para portal o integración genérica.
  5. Pulsa Crear bandeja y verifica el canal API.
  6. En Equipo selecciona agentes y guarda. Configuración permite renombrar la misma bandeja.

El campo opcional no es para la URL principal del CRM ni contraseñas. Si aún no hay destino, déjalo vacío y coordina la implementación. Sin webhook puede servir para una prueba interna, pero no confirma que las respuestas lleguen al sistema externo.

Formulario real de bandeja API con endpoint ficticio y Usar como SMS desmarcado.
Formulario real de bandeja API con endpoint ficticio y Usar como SMS desmarcado. Abre la imagen para ampliarla.

Comprende el webhook y ambos sentidos

ParteResponsabilidad
EntradaEl sistema externo envía o importa mensajes a conversación y contacto correctos.
Eventos y respuestasEl endpoint recibe eventos; el integrador decide cuáles generan salida.
Entrega externaEl integrador envía respuestas al portal o canal y registra resultados.

Aunque el rótulo diga Webhook de entrada, es el endpoint de la integración que recibe eventos de la bandeja. No es una URL generada por CRMDAY para enviar mensajes al CRM. El técnico debe confirmar dirección, eventos, autenticación y respuestas antes de activar.

Comprueba que entradas no se reenvíen como respuestas, notas internas no lleguen al cliente y eventos repetidos no dupliquen entregas. Credenciales y validación pertenecen a la implementación, no al nombre de bandeja. El registro no garantiza estos comportamientos.

Utiliza clasificación SMS solo cuando corresponda

Propietarios y administradores pueden marcar Usar como SMS en API configurables. La clasificación muestra SMS y permite elegirla en flujos de ese canal. Puede definirse al crear o en la tarjeta. Para revertir una clasificación manual permitida, desmarca y comprueba el retorno a API.

Marca solo con integración SMS preparada y validada. Clasificar no conecta operadora, compra número, aprueba registro ni convierte webhook genérico en SMS. Las bandejas gestionadas por telefonía tienen clasificación propia y pueden no mostrar el control. La imagen clasifica un portal solo para mostrar el efecto visual; no representa SMS real.

Clasificación SMS demostrativa en tarjeta API. Esta opción no conecta un servicio SMS.
Clasificación SMS demostrativa en tarjeta API. Esta opción no conecta un servicio SMS. Abre la imagen para ampliarla.

Valida antes de habilitar la integración

  1. Pide un mensaje ficticio con identificador estable de remitente.
  2. Comprueba bandeja, contacto y contenido en Conversaciones.
  3. Responde desde CRM y confirma recepción en el portal o aplicación.
  4. Agrega una nota interna y confirma que no llegue al cliente.
  5. Pide una repetición controlada de evento y revisa duplicados.
  6. Prueba con un agente autorizado y define quién supervisa errores y disponibilidad.

Si entra pero no responde, revisa webhook y envío externo. Si no llega nada, comprueba envío, agencia y bandeja. Configurada indica registro, no salud del endpoint. Antes de reenviar un mensaje incierto, verifica entrega previa. No elimines la bandeja para cambiar URL: coordina mantenimiento técnico y conserva historial.

Guías relacionadas

Actualizado el 25 de octubre de 2026.