Skip to main content
La Chat API te permite enviar y recibir mensajes directos cifrados de extremo a extremo 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 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 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 solo el 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 a 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 E2EE
  2. Primeros pasos — implementa claves, envío y recepción
  3. Chat XDK — referencia del SDK de cifrado
  4. Eventos en tiempo real, Multimedia o Solución de problemas cuando necesites esos temas