Skip to main content
Chat in-app es la conversación dentro de tu producto. No es el Chat en el sitio (widget con IA en la página). Aquí el usuario ya está autenticado en tu app.

​
¿Qué es Chat en Notifique?

El canal para mensajes 1:1 y grupos en iOS, Android o web de tu producto. Creas un Chat App en el workspace, das de alta usuarios con un externalUserId estable y emites un JWT en tu backend. La app móvil o el front nunca ve el signing secret. Puedes:
  • Crear Chat Apps con orígenes permitidos (CORS) y flags de lo que el JWT puede hacer
  • Sincronizar usuarios (PUT /v1/chat/users) y agentes del equipo (POST /v1/chat/agents)
  • Emitir JWT (POST /v1/chat/users/token) con TTL de 60 s a 24 h (por defecto 1 h)
  • Abrir conversaciones 1:1 o grupo con la API Key; el cliente solo crea si activas las flags
  • Enviar y listar mensajes por REST (POST /v1/chat/messages) o WebSocket
  • Espejar en Inbox automáticamente
  • Recibir webhooks chat.received (usuario) y chat.sent (agente), más ciclo de conversación y miembros
A diferencia de WhatsApp, el chat no usa instancia de canal. Basta Chat App, usuarios y API Key (o JWT del usuario) con los alcances correctos.

​
Identidad

El id del usuario en tu sistema es externalUserId (inmutable). Notifique guarda un chatUserId interno. El JWT lleva: El signing secret queda en el servidor. Rótalo en el panel o con POST /v1/chat/apps/{id}/rotate-secret.

​
Tiempo real

Conecta a wss://api.notifique.dev/v1/chat/ws. No pongas el JWT en la query. Primer frame:
Luego auth.ok. Después: subscribe / unsubscribe, message.send, message.read, typing.start / typing.stop, ping → pong. Hay un tope de conexiones simultáneas por plan. Si se supera, el gateway rechaza el socket.

​
Cobro y límites

Cada mensaje enviado usa el SKU CHAT_MESSAGE: 1 crédito (o R$ 0,01 en Pague por uso). Los mismos números aparecen en Planes y precios del panel.

​
Flags por defecto (restrictivas)

  • allowClientCreateDirect = false
  • allowClientCreateGroup = false
  • allowClientAddMembers = false
El JWT no crea conversación ni agrega miembros. La API Key sí. JWT con la flag apagada → 403 CHAT_CLIENT_CREATE_DISABLED.

​
Cuándo usarlo

Inbox del producto, soporte 1:1 y grupos pequeños. Difusión, OTP o reenganche fuera de la app → Push, email o WhatsApp. Widget en landing → Chat en el sitio.
Cada API Key pertenece a un workspace. En v1 no envíes x-workspace-id.

​
Próximos pasos