- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- MessageReplyOption
- Pruébalo
Crea un mensaje en un espacio de Google Chat. Para ver un ejemplo, consulta Cómo enviar un mensaje.
El método create()
requiere autenticación del usuario o autenticación de la app. Chat atribuye al remitente del mensaje de forma diferente según el tipo de autenticación que uses en tu solicitud.
En la siguiente imagen, se muestra cómo Chat atribuye un mensaje cuando usas la autenticación de apps. Chat muestra la app de Chat como el remitente del mensaje. El contenido del mensaje puede incluir texto (text
), tarjetas (cardsV2
) y widgets de accesorios (accessoryWidgets
).
En la siguiente imagen, se muestra cómo Chat atribuye un mensaje cuando usas la autenticación de usuarios. Chat muestra al usuario como el remitente del mensaje y atribuye la app de Chat al mensaje mostrando su nombre. El contenido del mensaje solo puede contener texto (text
).
El tamaño máximo del mensaje, incluido su contenido, es de 32,000 bytes.
En el caso de las solicitudes de webhook, la respuesta no contiene el mensaje completo. La respuesta solo propaga los campos name
y thread.name
, además de la información que estaba en la solicitud.
Solicitud HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. Es el nombre del recurso del espacio en el que se creará un mensaje. Formato: |
Parámetros de consulta
Parámetros | |
---|---|
threadKey |
Opcional. Obsoleto: Usa |
request |
Opcional. Un ID de solicitud único para este mensaje. Si especificas un ID de solicitud existente, se muestra el mensaje creado con ese ID en lugar de crear uno nuevo. |
message |
Opcional. Especifica si un mensaje inicia una conversación o responde una. Solo es compatible en los espacios con nombre. Cuando respondes a las interacciones del usuario, se ignora este campo. En el caso de las interacciones dentro de una conversación, la respuesta se crea en la misma conversación. De lo contrario, la respuesta se crea como una conversación nueva. |
message |
Opcional. Es un ID personalizado para un mensaje. Permite que las apps de Chat obtengan, actualicen o borren un mensaje sin necesidad de almacenar el ID asignado por el sistema en el nombre del recurso del mensaje (representado en el campo El valor de este campo debe cumplir con los siguientes requisitos:
Para obtener más información, consulta Cómo asignar un nombre a un mensaje. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Message
.
Cuerpo de la respuesta
Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Message
.
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.create
Para obtener más información, consulta la Guía de autorización.
MessageReplyOption
Especifica cómo responder un mensaje. Es posible que se agreguen más estados en el futuro.
Enumeraciones | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Predeterminado. Inicia una conversación nueva. Si usas esta opción, se ignora cualquier thread ID o que se incluya. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Crea el mensaje como una respuesta a la conversación especificada por thread ID o . Si falla, el mensaje inicia una conversación nueva. |
REPLY_MESSAGE_OR_FAIL |
Crea el mensaje como una respuesta a la conversación especificada por thread ID o . Si se usa un threadKey nuevo, se crea un subproceso nuevo. Si falla la creación del mensaje, se muestra un error NOT_FOUND . |