Comunicação
Google Chat no seu produto e nos seus agentes de IA, por uma API
O toolkit do Google Chat cobre espaços, mensagens diretas, mensagens, reações e membros, sempre agindo como o usuário que conectou. Seu cliente autoriza o Google uma vez com OAuth, e seu produto ou agente de IA chama cada operação pelo Connect, que guarda e renova as credenciais e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/google_chat_create_space/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"space": {}
}
}Como funciona
Do cliente conectado à primeira chamada no Google Chat.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Google Chat. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Google Chat.
Avisar equipes no chat
Envie uma mensagem do seu produto para um espaço ou mensagem direta, ou responda dentro de uma conversa existente quando um alerta ganha atualização.
Criar um espaço por projeto
Crie um espaço, convide as pessoas certas e adicione membros depois, quando alguém novo entra na conta ou no projeto.
Agente que entende o chat
Deixe um agente de IA buscar mensagens nos espaços do usuário, ler uma conversa e responder ou reagir em nome dele.
Tools
11 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.
- Criar reaçãoPOSTAdiciona uma reação com emoji do usuário a uma mensagem.
- Listar membrosGETLista os membros de um espaço com role e state. Os membros vêm como users/ seguido de um id, sem o nome de exibição; envie nextPageToken como pageToken para a próxima página.
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.
Perguntas sobre o toolkit do Google Chat
Preciso implementar a API do Google Chat?
Não. O Connect já traz 11 tools do Google Chat descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Google Chat?
Pelo modo que o toolkit aceita: OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
