O conector oferece ferramentas somente leitura. Cada módulo tem dois tipos:
- Agregação (
_aggregate) — conta, soma e tira médias agrupando por uma dimensão (mês, status, responsável…). Devolve só números, nunca registros individuais.
- Listagem (
_list) — devolve as linhas de um relatório, com filtros e ordenação.
O assistente escolhe sozinho qual ferramenta usar a partir da sua pergunta. Uma ferramenta só aparece se o módulo estiver ativo no workspace, se o seu papel tiver a permissão correspondente e se a permissão tiver sido concedida no consentimento.
| Ferramenta | O que devolve |
|---|
crm_contacts_aggregate | Quantidade de contatos por mês de criação, cidade, estado, país ou empresa. |
crm_contacts_list | Contatos com nome, e-mail, telefone, cidade, estado, país e data de criação, filtráveis pela empresa. |
crm_deals_aggregate | Negócios contados, somados ou com valor médio por estágio, pipeline, status, prioridade, responsável, empresa ou mês. |
crm_deals_list | Negócios com contato, pipeline, estágio, responsável, valor, status, prioridade e datas de fechamento, filtráveis pela empresa. |
crm_tasks_aggregate | Tarefas contadas por status, tipo, prioridade, responsável ou mês. |
crm_tasks_list | Tarefas com título, tipo, status, prioridade, responsável, contato, negócio e datas. Sem a descrição da tarefa. |
| Ferramenta | O que devolve |
|---|
finance_invoices_aggregate | Faturas contadas ou somadas (total, desconto, pago, saldo a receber) por status, cliente, moeda ou mês. |
finance_invoices_list | Faturas com número, status, cliente, datas, total, pago, saldo e se já venceu. |
finance_payments_aggregate | Pagamentos recebidos contados ou somados por meio de pagamento, origem, moeda ou mês. |
finance_payments_list | Pagamentos com fatura, cliente, meio de pagamento, origem, data e valor. |
Valores em moedas diferentes nunca são somados entre si: cada moeda sai numa linha.
| Ferramenta | O que devolve |
|---|
hospitality_occupancy | Taxa de ocupação num período, por mês ou categoria de quarto, com diárias ocupadas e disponíveis. |
hospitality_reservations_aggregate | Reservas contadas ou somadas (valor, diárias, hóspedes) por status, categoria, plano de tarifa, quarto ou mês. |
hospitality_reservations_list | Reservas com hóspede, categoria, quarto, plano de tarifa, datas, diárias, hóspedes, status e valor. Sem as notas da reserva. |
| Ferramenta | Permissão | O que devolve |
|---|
omnichannel_conversations_aggregate | omnichannel:read | Conversas contadas por status, canal, responsável ou mês, conversas sem resposta e tempo médio da primeira resposta. |
omnichannel_conversations_list | omnichannel:read | Conversas com contato, canal, status, responsável e datas. Sem nenhum texto de mensagem. |
omnichannel_messages_aggregate | omnichannel:read | Mensagens contadas por direção, tipo, canal ou mês. Sem nenhum texto de mensagem. |
omnichannel_costs_aggregate | omnichannel:read | O custo das mensagens do WhatsApp em reais por mês, categoria da Meta, número, origem ou negócio, estimado e conciliado com a Meta. Só aparece para quem vê os custos do WhatsApp. |
omnichannel_messages_list | omnichannel:messages:read | As mensagens de uma conversa, com o texto. Notas internas da equipe vêm marcadas como tal. |
- “Quantos contatos novos entraram por mês neste ano?”
- “Liste os 10 maiores negócios abertos e quem é o responsável por cada um.”
- “Quantas tarefas atrasadas cada pessoa da equipe tem?”
- “Quanto faturei em agosto? E quanto ainda tenho a receber das faturas vencidas?”
- “Quanto gastei com WhatsApp em outubro, por categoria?”
- “Qual meio de pagamento os clientes mais usam?”
- “Qual foi a ocupação de março por categoria de quarto?”
- “Qual o tempo médio da primeira resposta no WhatsApp por atendente?”
- Listagens devolvem no máximo 500 linhas por chamada e avisam quando a lista foi cortada.
- Agregações devolvem no máximo 1.000 grupos e também avisam quando cortam.
- A ocupação aceita períodos de até 36 meses.
- Cada conexão pode fazer até 60 chamadas por minuto. Acima disso, a chamada é recusada e o assistente precisa esperar um pouco.
