BotoZap

Consulta horários disponíveis para um serviço e período. Calcula horários livres usando jornada, exceções, buffers e calendários conectados. Cliente, responsável, serviço e `exclude_id` são UUIDs internos; `from`/`to` são instantes ISO 8601 com fuso. appointments:read.

get_appointment_availability

Consulta o conteúdo e o estado de uma mensagem autorizada. Busca uma mensagem pelo UUID interno do BotoZap ou pelo `wamid` atribuído pela Meta. Retorna { data }.

get_message

Consulta um negócio autorizado pelo UUID. Busca um cliente pelo id (uuid interno). Retorna { data }.

get_customer

Consulta os dados do número autorizado usado pelo atendimento. Busca um número pelo UUID interno do BotoZap ou pelo `phone_number_id` da Meta. Retorna { data }.

get_phone_number

Consulta uma oportunidade autorizada do CRM. Detalha opportunity, incluindo versão; crm:read.

get_opportunity

Consulta conteúdo, componentes e variáveis de um template autorizado. Busca um template pelo id (uuid interno). Retorna { data }.

get_template

Consulta a conta de canal autorizada para a app. Consulta a conta de canal autorizada para resolver o negócio de uma conversa.

get_channel_account

Consulta conversas vinculadas à demanda autorizada. Conversas vinculadas a demand, 20 por página; crm:read.

list_demand_conversations

Consulta conversas vinculadas à oportunidade autorizada. Conversas vinculadas a opportunity, 20 por página; crm:read.

list_opportunity_conversations

Cria um compromisso e pode sincronizar calendários externos; exige confirmação. Cria compromisso com vínculos CRM (IDs internos UUID). `meeting_requested` pode criar um link Google Meet pela conexão configurada. `idempotency_key` opcional (8–200 caracteres) retorna o mesmo compromisso se repetido com o mesmo conteúdo; reutilizá-la com conteúdo diferente causa conflito. appointments:write. Pedido de agendamento vago/incompleto ou com escolha de horário usa stage_appointment_booking. Crie diretamente só com serviço, pessoa, data/horário e instrução completa e explícita. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

create_appointment

Cria uma definição de template e solicita aprovação ao provedor, com permissão do usuário. Cria um template e o submete à Meta. Informe name, language, category e components (array no formato da Cloud API). Aponte a conexão via waba_connection_id OU phone_number_id. Retorna { data }. Criação de template novo continua direta com permissão do ChatGPT. stage_review_template serve apenas para enviar um template já aprovado, não para criar. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

create_template

Envia conteúdo ao destinatário pelo canal autorizado; exige confirmação do usuário e pode produzir efeito irreversível. Recomendado: use prepare_send_intent uma vez e reutilize idempotency_key em retries. Recusas confirmadas liberam a chave; após aguardar/corrigir, repita com a mesma chave. Resultado desconhecido exige conferir o histórico. Chamadas sem chave continuam aceitas, com o comportamento anterior sem deduplicação. Envia uma mensagem de WhatsApp ou Instagram ao destinatário via API do BotoZap. No Instagram, use IGSID e from da Conta de canal; interactive aceita button com web_url/postback ou generic com 1–10 cards; tag human_agent depende da flag e janela da API. O recibo Instagram traz wamid null, external_id, channel instagram e type interactive. `to` é o número E.164 ou wa_id. Para texto: type='text' e text={ body }. Para template: type='template' e template={ name, language, components? }. Botões/lista/link: type='interactive' e interactive={ type: 'button'|'list'|'cta_url', body, action, ... } (formato Cloud API). Localização: type='location' e location={ latitude, longitude, name?, address? }. Reação a uma mensagem recebida: type='reaction' e reaction={ message_id (UUID ou wamid), emoji } (emoji '' retira). Recusas de plano: 429 free_form_limit_reached (limite 1:1 do Free). `from` aceita ID Meta ou UUID interno do Número e é obrigatório se a conta tem mais de um. O envio pode entregar uma mensagem real. Retorna `id` (UUID interno do BotoZap) e `wamid` (ID da mensagem na Meta), além de `to` e `status`; em reação, também `reaction` { message_id, wamid, emoji, action }. Se ainda precisa preparar/revisar texto, use stage_review_reply; se precisa escolher template aprovado, stage_review_template. Envie diretamente só com destinatário, origem e conteúdo completos e ordem explícita de enviar. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Pedidos de acompanhar, monitorar, ver status ou "follow" usam SOMENTE open_live_conversation: nunca enviar, reenviar ou preparar nova mensagem nesses pedidos, mesmo após um envio confirmado. message_id é opcional e, sem ele, acompanha a última mensagem enviada na conversa. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

send_message

Consulta disponibilidade e prepara um agendamento para confirmação. Prepara horários disponíveis para a conversa, serviço e responsável escolhidos. Não marca nem envia aviso. Para pedido vago de agendamento ou escolha de serviço/horário, use esta UI de disponibilidade antes de criar. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

stage_appointment_booking

Consulta mensagens de uma conversa, com paginação e filtros. Lista mensagens da conta (paginação por cursor: { data, paging }). Filtros opcionais por número (ID Meta ou UUID interno), conversa (UUID interno), direção, status, tipo e presença de mídia; `sort` escolhe a ordem. Cada mensagem traz `source` (api, app, history, broadcast).

list_messages

Consulta alertas por estado; open e acknowledged ainda precisam de revisão. GET /ai/alerts. agents:read; chave live. Operação list sobre recursos do grupo alerts. Use customer_id do cliente autorizado; não confunda com account_id. Paginação por offset: page começa em 1; per_page aceita até 100 quando disponível. Use meta para acompanhar total_count/total_pages.

ai_alerts_list

Consulta casos de atendimento que precisam de intervenção humana. GET /ai/cases. agents:read; chave live. Operação list sobre recursos do grupo cases. Use customer_id do cliente autorizado; não confunda com account_id. Paginação por offset: page começa em 1; per_page aceita até 100 quando disponível. Use meta para acompanhar total_count/total_pages.

ai_cases_list

Consulta compromissos autorizados da agenda. Lista compromissos por Cliente, contato, responsável, serviço, status ou período. Todos os IDs são UUIDs internos do BotoZap; `date` é um dia UTC e `from`/`to` são instantes ISO 8601 com fuso. Paginação offset: `page` começa em 1, `per_page` aceita até 100; consulte `meta` para totais. appointments:read.

list_appointments

Lista contatos da conta autorizada. Lista contatos da conta (paginação por cursor: { data, paging }). Filtros opcionais por cliente, presença de cliente, busca parcial em nome/wa_id e janela de criação.

list_contacts

Lista conversas autorizadas, com filtros de negócio e agente pausado. Lista conversas da conta (paginação por cursor: { data, paging }). Filtros opcionais por número (ID Meta ou UUID interno), status e busca textual de contato.

list_conversations

Lista os negócios autorizados sem abrir outra tela. Lista os clientes (customers) da conta (paginação offset: { data, meta }).

list_customers

Lista os números e canais autorizados para escolher a origem. Lista os números conectados da conta (paginação offset: { data, meta }; page é 1-based e per_page tem máximo 100). Em cada resultado, `id` é UUID interno do BotoZap e `phone_number_id` é o identificador da Meta. Filtro opcional por cliente.

list_phone_numbers

Consulta serviços de agenda disponíveis no negócio. Lista services do Cliente (100 por página). appointments:read.

list_appointment_services

Lista templates do número autorizado e seu estado de aprovação. Lista templates da conta (paginação offset: { data, meta }). Filtros opcionais por status, categoria e conexão WABA.

list_templates

Abre negócios e pendências para revisar um atendimento. Abre o painel de revisão BotoZap e retorna a conta autorizada e uma página de clientes. Também pode ser usado sem interface visual. Abra Pendências para consultar prioridades e escolher a conversa. open_botozap e list_radar são alternativas: nunca chame ambas na mesma resposta. Para "mostrar pendências e preparar resposta a X", mostre no máximo uma tela de Pendências e depois use stage_review_reply para a conversa de X. Se o pedido principal é preparar resposta e o radar está vazio, vá direto a stage_review_reply; não abra Pendências apenas para mostrar uma lista vazia. Para descobrir IDs ou localizar X, use list_customers, list_contacts ou list_conversations sem UI; não abra outra tela para descobrir IDs nem acrescente open_review_panel como tela de Pendências duplicada. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

open_review_panel

Altera a automação da conversa; retomar pode gerar resposta ao cliente e exige confirmação explícita. Pausa/retoma agente na conversa. agents:write; retomar pode gerar resposta automática e exige intenção do usuário.

control_conversation_agent

Abre as pendências da conta para escolher o próximo atendimento. Abre Pendências no BotoZap. Links de conversa são conferidos pelas tools autorizadas; não envia mensagens. Para "o que tenho pendente", resumo do dia ou ver pendências, abra esta UI de Pendências sem encadear consultas exploratórias. open_botozap e list_radar são alternativas: nunca chame ambas na mesma resposta. Para "mostrar pendências e preparar resposta a X", mostre no máximo uma tela de Pendências e depois use stage_review_reply para a conversa de X. Se o pedido principal é preparar resposta e o radar está vazio, vá direto a stage_review_reply; não abra Pendências apenas para mostrar uma lista vazia. Para descobrir IDs ou localizar X, use list_customers, list_contacts ou list_conversations sem UI; não abra outra tela para descobrir IDs nem acrescente open_review_panel como tela de Pendências duplicada. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

open_botozap

Consulta pendências priorizadas de um negócio. Lista pendências e contagens críticas/atenção/programadas; crm:read. Exibe o carrossel de Pendências de um negócio. Para descobrir negócios ou ver o resumo do dia, prefira open_botozap. open_botozap e list_radar são alternativas: nunca chame ambas na mesma resposta. Para "mostrar pendências e preparar resposta a X", mostre no máximo uma tela de Pendências e depois use stage_review_reply para a conversa de X. Se o pedido principal é preparar resposta e o radar está vazio, vá direto a stage_review_reply; não abra Pendências apenas para mostrar uma lista vazia. Para descobrir IDs ou localizar X, use list_customers, list_contacts ou list_conversations sem UI; não abra outra tela para descobrir IDs nem acrescente open_review_panel como tela de Pendências duplicada. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

list_radar

Gera a chave de uma nova intenção de envio, sem enviar; preserve a chave ao conferir resultado incerto. Gera uma chave para uma nova intenção de envio autorizada pelo usuário, sem enviar. Passe a chave para send_message, send_media_message ou reply_to_conversation e preserve-a em todo retry. Não crie outra chave para resolver timeout ou envio pendente.

prepare_send_intent

Prepara uma resposta com histórico para revisão; não envia. Prepara um rascunho editável no painel de revisão após confirmar acesso à conversa. Não envia mensagem. Para preparar, redigir ou revisar resposta, publique o rascunho neste card; não use o bloco nativo de texto. Não envia. open_botozap e list_radar são alternativas: nunca chame ambas na mesma resposta. Para "mostrar pendências e preparar resposta a X", mostre no máximo uma tela de Pendências e depois use stage_review_reply para a conversa de X. Se o pedido principal é preparar resposta e o radar está vazio, vá direto a stage_review_reply; não abra Pendências apenas para mostrar uma lista vazia. Para descobrir IDs ou localizar X, use list_customers, list_contacts ou list_conversations sem UI; não abra outra tela para descobrir IDs nem acrescente open_review_panel como tela de Pendências duplicada. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Pedidos de acompanhar, monitorar, ver status ou "follow" usam SOMENTE open_live_conversation: nunca enviar, reenviar ou preparar nova mensagem nesses pedidos, mesmo após um envio confirmado. message_id é opcional e, sem ele, acompanha a última mensagem enviada na conversa. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

stage_review_reply

Prepara o envio de um template já aprovado; não cria nem envia. Abre revisão de template aprovado para uma conversa. Não envia mensagem. Para escolher/preparar o ENVIO de um template já aprovado numa conversa, abra esta UI. Criar template novo usa create_template diretamente; esta UI não cria templates. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

stage_review_template

Envia uma resposta na conversa autorizada após confirmação explícita. Recomendado: use prepare_send_intent uma vez e reutilize idempotency_key em retries. Recusas confirmadas liberam a chave; após aguardar/corrigir, repita com a mesma chave. Resultado desconhecido exige conferir o histórico. Chamadas sem chave continuam aceitas, com o comportamento anterior sem deduplicação. Responde uma Conversa com texto. Informe o UUID da Conversa e o corpo; o BotoZap resolve Contato e Número, e a API revalida Conta, ambiente, janela de 24h, quota e billing. Exige scopes conversations:read e messages:send. Para preparar/redigir/revisar resposta use stage_review_reply. Responda diretamente só com conversa e texto completos e ordem explícita de enviar. Pedido completo e explícito de executar: use a tool direta correspondente, com a permissão do ChatGPT. Pedido vago/incompleto, com escolha a fazer, ou para preparar, redigir, revisar ou ver pendências: use a UI antes de executar; não substitua o card por texto ou bloco nativo. Exceção: criar template novo mantém create_template direta com permissão, nunca a UI de envio. Pedidos de acompanhar, monitorar, ver status ou "follow" usam SOMENTE open_live_conversation: nunca enviar, reenviar ou preparar nova mensagem nesses pedidos, mesmo após um envio confirmado. message_id é opcional e, sem ele, acompanha a última mensagem enviada na conversa. Webhooks, credenciais de IA e configurações administrativas são feitos exclusivamente no painel BotoZap: https://botozap.com.br. Oriente a abrir o painel; nunca sugira habilitar ou expor ações administrativas no plugin e nunca peça chaves, tokens ou senhas no chat.

reply_to_conversation

Consulta nomes dos responsáveis autorizados para a tela de agendamento. Lista os usuários (membros) da conta. Paginação offset: { data, meta }.

list_users

Consulta o template e verifica as variáveis antes do envio. Revisa variáveis em formulário nativo quando o host oferece openai/elicitation; fallback retorna os valores para edição na UI. Não envia.

review_template_variables

Retorna a identidade da Conta BotoZap autorizada por esta credencial.