Skip to main content
La X Chat API te permite enviar y recibir mensajes directos cifrados en X. Los cuerpos de los mensajes se cifran en el cliente; X enruta el texto cifrado y no puede leer el contenido en texto plano. Los mensajes también se firman para que los destinatarios puedan verificar al remitente.

Lo que necesitas en tu aplicación

Sigue Primeros pasos para una implementación completa. Si solo quieres conceptos, consulta el Manual básico de criptografía.

Cómo funciona el cifrado (resumen)

  1. Crea pares de claves de identidad y de firma; guarda las claves privadas de forma segura (copia de seguridad segura de claves o un blob protegido).
  2. Publica las claves públicas para que otros puedan intercambiar claves de conversación contigo y verificar tus firmas.
  3. Comparte una clave de conversación publicando copias cifradas para cada participante.
  4. Cifra y firma los mensajes salientes; envía a X únicamente texto cifrado.
  5. Recibe texto cifrado a través de webhooks, stream o historial de eventos.
  6. Verifica y descifra con el Chat XDK.

Endpoints útiles

Agrupados bajo API reference en la barra lateral, incluyen:
  • Claves públicas: registrar y consultar
  • Conversaciones y mensajes: listar/obtener conversaciones, agregar/rotar claves, eventos, enviar, escribiendo, leído, membresía de grupo
  • Multimedia: subir y descargar adjuntos cifrados (guía)

Notas de autenticación

Usa OAuth 2.0 user context con los scopes relacionados con DM (dm.read, dm.write, además de users.read / tweet.read según sea necesario; media.write para subidas). La actividad de X Chat de un usuario requiere la autorización de ese usuario. La configuración de la copia de seguridad segura de claves se devuelve en tu registro de clave pública (campo juicebox_config); consulta Primeros pasos.

Próximos pasos

  1. Manual básico de criptografía: antecedentes opcionales sobre conceptos de cifrado
  2. Primeros pasos: implementa claves, envío y recepción
  3. Chat XDK: referencia del SDK de cifrado
  4. Cómo crear apps de UI con WASM y Manejo de claves privadas: mantén las claves en el dispositivo y trata los PIN como credenciales raíz
  5. Eventos en tiempo real, Multimedia o Solución de problemas cuando necesites esos temas