Genérico entrante
El genérico de entrada es el punto de acceso universal a AiHummer. Cuando no existe un canal diseñado específicamente para tu fuente —un correo electrónico a webhook, un trabajo cron, una herramienta interna— publicas el mensaje en un punto de acceso y entra al motor de turnos como cualquier otro mensaje de canal.
El punto final
Enviar un solo JSON POST a la puerta de enlace:
POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>
{
"channel": "my-app",
"external_id": "user-42",
"text": "Hello from my custom integration"
}El cuerpo contiene tres campos:
channel— un nombre de canal lógico que elijas para la fuente.external_id— un identificador estable para el usuario final o la conversación.text— el contenido del mensaje.
Autenticación
El punto final está protegido por un HMAC llevado en el X-AIHummer-Inbound-Secret encabezado, derivado del compartido AIHUMMER_INBOUND_SECRET. Las solicitudes sin una firma válida son rechazadas, por lo que solo los que poseen el secreto pueden inyectar mensajes.
[!NOTE] La puerta de enlace debe tener un espacio de trabajo predeterminado configurado (
AIHUMMER_DEFAULT_WORKSPACE_ID) para enviar mensajes entrantes genéricos.
Conectores de canal adicionales
AiHummer ofrece conectores de canal adicionales. Cada uno se instala desde el Marketplace, se ejecuta de manera nativa en su propio puerto y reenvía los mensajes entrantes a /v1/inbound/generic.
| conectora | Puerto | Notas |
|---|---|---|
| Discord | 8801 | |
| Holgura | 8802 | |
| Matriz | 8803 | |
| Señal | 8804 | requiere un signal-cli sidecar |
| Microsoft Teams | 8805 | |
| Correo electrónico (IMAP/SMTP) | 8806 | |
| API en la nube de WhatsApp | 8807 |
[!NOTE] Los conectores se instalan desde el Marketplace; algunos necesitan un servicio adicional (por ejemplo,
signal-clipara Signal).
La extensión del navegador
AiHummer también envía una extensión de navegador, una Panel lateral de Manifest V3 superficie de chat. Es una cliente de /v1/chat/completions usando un personal ah- Clave de API — no es un canal del lado del servidorÚsalo para chat personal en el navegador en lugar de como una fuente de entrada para enrutamiento.
¿A dónde vamos ahora?
- Para el chat de producción, vea Telegram y MÁX.
- Para el IM del personal, ver Bitrix24.
- ¿Construyendo contra la API? Ver chat/completions.