Method: spaces.messages.create

Cria uma mensagem. Para ver um exemplo, consulte Criar uma mensagem.

Requer autenticação.

A criação de uma mensagem de texto é compatível com a autenticação do usuário e a autenticação do app. A autenticação do usuário exige o escopo de autorização chat.messages ou chat.messages.create.

A criação de uma mensagem de cartão é compatível apenas com a autenticação de app e requer esse uso.

Como o Chat fornece autenticação para webhooks como parte do URL gerado quando um webhook é registrado, eles podem criar mensagens sem uma conta de serviço ou autenticação do usuário.

Solicitação HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso do espaço em que uma mensagem será criada.

Formato: spaces/{space}

Parâmetros de consulta

Parâmetros
threadKey
(deprecated)

string

Opcional. Obsoleto: use thread.thread_key. Identificador de thread opaco. Para iniciar ou adicionar a uma linha de execução, crie uma mensagem e especifique um threadKey ou o thread.name. Para ver um exemplo de uso, consulte Iniciar ou responder a uma conversa.
requestId

string

Opcional. Um código de solicitação exclusivo para esta mensagem. Especificar um ID de solicitação existente retorna a mensagem criada com esse ID em vez de criar uma nova mensagem.
messageReplyOption

enum (MessageReplyOption)

Opcional. Especifica se uma mensagem inicia uma conversa ou se responde a uma. Compatível apenas com espaços nomeados.
messageId

string

Opcional. Um nome personalizado para uma mensagem do Chat atribuída na criação. Precisa começar com client- e conter apenas letras minúsculas, números e hifens com até 63 caracteres. Especifique este campo para receber, atualizar ou excluir a mensagem com o valor especificado. A atribuição de um nome personalizado permite que um app de chat retorne a mensagem sem salvar a mensagem name do corpo da resposta retornada ao criá-la. A atribuição de um nome personalizado não substitui o campo name gerado, o nome do recurso da mensagem. Em vez disso, ele define o nome personalizado como o campo clientAssignedMessageId, que pode ser referenciado ao processar operações posteriores, como atualizar ou excluir a mensagem. Para ver um exemplo de uso, consulte Nomear uma mensagem criada.

Corpo da solicitação

O corpo da solicitação contém uma instância de Message.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Message.

Escopos de autorização

Requer um dos seguintes escopos 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 mais informações, consulte o Guia de autorização.

MessageReplyOption

Especifica como responder a uma mensagem. Mais estados podem ser adicionados no futuro.

Enums
MESSAGE_REPLY_OPTION_UNSPECIFIED Padrão. Inicia uma conversa.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Cria a mensagem como uma resposta à conversa especificada por thread ID ou threadKey. Se falhar, a mensagem iniciará uma nova conversa.
REPLY_MESSAGE_OR_FAIL Cria a mensagem como uma resposta à conversa especificada por thread ID ou threadKey. Se ela falhar, um erro NOT_FOUND será retornado.