Criar reação no Google Chat, por uma API
Adiciona uma reação com emoji do usuário a uma mensagem.
- Identificador
- google_chat_create_reaction
A chamada
POST https://connect.reportei.com/api/tools/google_chat_create_reaction/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"spaceId": "<spaceId>",
"messageId": "<messageId>",
"emoji": {}
}
}Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.
Parâmetros
As descrições dos parâmetros seguem a documentação oficial do app, em inglês.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| spaceId | string | Sim | Id of the space: the part after spaces/ in the name from List spaces. |
| messageId | string | Sim | Id of the message: the part after messages/ in its name, from List messages or Search messages. |
| emoji | object | Sim | The emoji of the reaction. |
Conexões possíveis
O seu cliente conecta a conta do Google Chat uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/google_chat, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
A resposta
Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.
Pronta para agentes de IA
O input desta tool é um JSON Schema, disponível em GET /api/tools/google_chat_create_reaction. Ele vira a definição de tool do seu agente sem conversão.
Outras tools do Google Chat
- Listar espaçosGETLista os espaços, chats em grupo e mensagens diretas de que o usuário participa, com name, displayName e spaceType. A parte do name depois de spaces/ é o spaceId das outras ferramentas, e chats em grupo e mensagens diretas só aparecem depois da primeira mensagem.
- Obter mensagem diretaGETRetorna o espaço de mensagem direta entre o usuário e outra pessoa; a parte do name depois de spaces/ é o spaceId de Send message. Responde 404 quando os dois ainda não têm mensagem direta, que Create space inicia.
- Criar espaçoPOSTCria um espaço com o usuário e convida outras pessoas. SPACE exige displayName e aceita até 49 pessoas; GROUP_CHAT exige ao menos duas pessoas e nenhum nome; DIRECT_MESSAGE exige exatamente uma pessoa e retorna a mensagem direta existente quando há uma.
- Listar mensagensGETLista as mensagens de um espaço, das mais antigas às mais novas por padrão, com name, sender, createTime, text e thread. Os remetentes vêm como users/ seguido de um id, sem o nome de exibição; envie nextPageToken como pageToken para a próxima página.
- Buscar mensagensPOSTBusca mensagens por palavras-chave em todos os espaços e mensagens diretas do usuário, das mais recentes às mais antigas. Cada resultado traz a mensagem, cujo name leva os ids do espaço e da mensagem; mensagens de apps do Chat, mensagens privadas e espaços silenciados ficam de fora.
- Enviar mensagemPOSTEnvia uma mensagem de texto do usuário para um espaço ou mensagem direta. Para responder em uma conversa, envie thread com o nome da conversa de List messages e messageReplyOption; sem messageReplyOption a mensagem inicia uma nova conversa.
- Atualizar mensagemPATCHAltera o texto de uma mensagem, com updateMask definido como text.
- Excluir mensagemDELETEExclui uma mensagem. Uma mensagem com respostas em uma conversa só é excluída com force true, que exclui as respostas também.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
