Já no ChatGPT e ClaudeConectar

Conecte o Chatfuel MCP ao Square MCP

A agenda, os pagamentos com cartão e o programa de pontos da sua clínica ficam na Square, e os clientes escrevem pelo WhatsApp e pelo Instagram. O assistente agenda os pedidos deles no Square Appointments, estorna uma cobrança em dobro e avisa na conversa, e ensina ao Agente de IA as regras de agendamento e as promoções de pontos da Square.

O que a integração faz

As tools que o assistente usa em cada lado, com os nomes que cada servidor dá a elas.

Chatfuel MCP
ToolO que faz
list_chatsLista as conversas com clientes com canal, status e etapa do lead.
get_chatMostra as últimas mensagens de uma conversa com um cliente, com canal, status e etapa do lead.
send_chat_messageEnvia ao cliente, na conversa dele, o texto que você aprovou e passa a conversa para o chat ao vivo.
return_chat_to_aiDevolve ao Agente de IA uma conversa que está no chat ao vivo, depois do seu sim, e o Agente de IA responde a última mensagem do cliente.
get_knowledge_baseMostra o que o Agente de IA usa para responder: dados da empresa, instruções, horário de atendimento, FAQ, serviços e profissionais.
add_faqAdiciona perguntas e respostas ao FAQ que o Agente de IA usa para responder.
set_business_hoursSubstitui o horário semanal que o Agente de IA informa aos clientes, depois da sua confirmação. Os dias que ficarem de fora ficam fechados.
test_replyEnvia uma mensagem de cliente de teste para uma conversa de teste e devolve a resposta do Agente de IA.
list_postsLista os posts e reels recentes da conta do Instagram e da página do Facebook conectadas ao seu bot.
setup_comment_repliesConfigura respostas com IA ou fixas aos comentários, a todos ou por palavra-chave; no Instagram e no Facebook, também uma DM e a escolha dos posts.
Square MCP
ToolO que faz
get_service_infoLista os métodos de um serviço da API da Square, como bookings, payments ou loyalty, e o que cada um faz.
get_type_infoMostra os campos que um método da API da Square espera, para o assistente montar uma requisição válida antes de chamá-lo.
make_api_requestExecuta um método da API da Square: lê ou altera clientes, agendamentos, pagamentos, reembolsos, locais, fidelidade e o resto da API.

O que pedir ao assistente

Pedido de horário na conversa → um agendamento no Square Appointments

QuandoUma cliente que já foi à clínica pede pelo Instagram um Peeling neste sábado de manhã e digita o telefone. A sua agenda fica no Square Appointments, então o Agente de IA passa a conversa para a equipe em vez de agendar no Chatfuel.

  1. O Chatfuel MCP encontra com list_chats as conversas que esperam a equipe, e get_chat lê o serviço, o dia e o telefone que ela digitou.
  2. Com get_type_info, o Square MCP devolve os campos de cada chamada. Depois, make_api_request acha o perfil dela por esse telefone e lista os horários livres de Peeling no sábado de manhã.
  3. Você escolhe um horário, e make_api_request cria o agendamento no perfil dela com o serviço, a profissional e a sua unidade.
  4. send_chat_message confirma o horário na conversa do Instagram depois do seu sim ao texto, e return_chat_to_ai devolve a conversa ao Agente de IA com mais um sim.

ResultadoA visita aparece na agenda da Square junto com os outros atendimentos, e a cliente recebe o horário na mesma conversa em que escreveu. Se nenhum perfil tiver o número dela, o assistente avisa e pergunta antes de criar um.

Peça

A Júlia Siqueira pediu pelo Instagram um Peeling neste sábado de manhã e digitou o telefone. Encontre ela na Square, me mostre os horários livres de sábado de manhã, agende o que eu escolher e escreva uma confirmação para a conversa dela.

Conversa do Instagram no Chatfuel: a cliente pede um Peeling no sábado e digita o telefone, e uma colega confirma o horário agendado na Square

Regras de cancelamento e horário na Square → o que o Agente de IA responde

QuandoNas conversas, os clientes perguntam sempre até quando dá para remarcar e o que acontece se faltarem. As respostas já estão nas configurações do Square Appointments.

  1. O Square MCP lê com make_api_request o seu perfil de agendamentos: o prazo de 24 horas para cancelar ou remarcar, a taxa de R$ 60 por falta e o texto da política. Também lê o horário semanal da unidade.
  2. O Chatfuel MCP confere com get_knowledge_base o que o FAQ já cobre, e add_faq inclui duas respostas: remarcar ou cancelar um horário, e faltar a ele.
  3. set_business_hours passa ao Agente de IA o mesmo horário semanal da unidade na Square, depois da sua confirmação.
  4. test_reply pergunta ao Agente de IA numa conversa de teste se o horário de amanhã cedo ainda pode ser remarcado.

ResultadoAs respostas na conversa batem com a Square: o mesmo prazo, a mesma taxa, o mesmo horário. Se você mudar a política na Square, o Agente de IA continua com a resposta antiga até você pedir ao assistente para atualizá-la.

Peça

Leia no Square Appointments o nosso prazo de cancelamento, a taxa por falta e o horário de funcionamento. Inclua no FAQ respostas sobre remarcar, cancelar e faltar, passe o mesmo horário ao Agente de IA e teste o que ele diz sobre remarcar o horário de amanhã.

FAQ do Chatfuel com duas respostas novas vindas da Square: remarcar ou cancelar um horário e a taxa por falta

“Fui cobrada duas vezes” na conversa → a cobrança duplicada estornada na Square

QuandoUma cliente escreve pelo WhatsApp que a recepção cobrou duas vezes a Hidratação facial de hoje no cartão: R$ 180 duas vezes, cartão final 4821. O Agente de IA passa a conversa para a equipe.

  1. O Chatfuel MCP lista com list_chats as conversas que esperam a equipe, e get_chat lê o valor, o dia e os quatro últimos dígitos que ela informou.
  2. O Square MCP lista com make_api_request os pagamentos de hoje, filtrados pelo total de R$ 180 e pelo final do cartão, e encontra dois pagamentos concluídos com um minuto de diferença.
  3. Você confere os dois e aprova, e make_api_request estorna o segundo e consulta o status do estorno: pendente ou concluído.
  4. send_chat_message avisa que a cobrança duplicada foi estornada e quando o dinheiro aparece, assim que você aprova o texto. Depois, return_chat_to_ai devolve a conversa ao Agente de IA.

ResultadoA cliente recebe o estorno confirmado na mesma conversa, sem esperar uma ligação no dia seguinte. A Square conclui a maioria dos estornos em poucas horas, e o banco dela pode levar de 7 a 10 dias úteis para mostrar o valor.

Peça

A Bianca Sampaio disse no WhatsApp que hoje foi cobrada duas vezes em R$ 180 no cartão final 4821. Encontre os dois pagamentos na Square, estorne o duplicado quando eu confirmar e escreva uma resposta dizendo quando o dinheiro volta.

Conversa do WhatsApp no Chatfuel: a cliente avisa de uma cobrança em dobro, e uma colega confirma o estorno de R$ 180

Pontos em dobro no Square Loyalty → uma DM para cada comentário com PONTOS

QuandoDe 1 a 14 de dezembro, cada Hidratação facial vale o dobro de Pontos Nuvia. Você anuncia num post do Instagram e quer que cada pessoa que comentar receba os detalhes por DM.

  1. get_service_info lista os métodos de fidelidade da Square, e make_api_request lê o seu programa: 1 ponto por visita e 5 pontos para R$ 60 de desconto num procedimento.
  2. make_api_request cria a promoção: multiplicador de 2× na Hidratação facial de 1 a 14 de dezembro. A Square deixa a promoção agendada até o primeiro dia.
  3. O Chatfuel MCP encontra o post com list_posts, e setup_comment_replies responde a cada comentário com PONTOS: uma resposta pública curta e uma DM com as datas, a recompensa e o convite para agendar.
  4. add_faq coloca a promoção no FAQ, para o Agente de IA responder às dúvidas que chegarem na DM.

ResultadoCada pessoa que comenta recebe a oferta por DM, e quem participa do programa ganha os pontos extras no pagamento enquanto a promoção está ativa. A Square vincula os pontos ao telefone da cliente. No TikTok o comentário não recebe DM, então a resposta pública convida a pessoa a escrever primeiro.

Peça

No Square Loyalty, dobre os pontos da Hidratação facial de 1 a 14 de dezembro. Depois configure respostas no nosso último post do Instagram: comentários com PONTOS recebem uma DM com as datas e a recompensa. Coloque a promoção no nosso FAQ também.

Respostas a comentários no Chatfuel: palavra-chave PONTOS, uma resposta pública e uma DM sobre pontos em dobro na Hidratação facial

Como conectar

  1. Adicione o Chatfuel MCP

    Conecte o Chatfuel pelo diretório do Claude ou do ChatGPT, ou passe ao Cursor o endereço https://mcp.chatfuel.com/panel, e entre com a sua conta do Chatfuel.

  2. Adicione o Square MCP

    O Claude tem a Square no diretório. O ChatGPT recebe https://mcp.squareup.com/mcp como servidor MCP próprio, e o Cursor chega lá pelo npx mcp-remote. Entre na Square como dono da conta ou com um membro da equipe com permissão total.

  3. Peça tudo numa conversa

    O Square MCP tem três tools genéricas, então o assistente consulta o método e os campos antes de cada chamada. O Chatfuel pede o seu sim antes de mudar o bot ou escrever para um cliente.

  1. Conecte o Chatfuel pelo diretório de conectores do Claude e entre na sua conta.
  2. No mesmo diretório, procure a Square (feito pela Square, Inc.) e clique em Connect.
  3. Entre na Square na página que abrir e autorize o acesso. Depois ative as tools da Square que precisar no menu de ferramentas da conversa, como mostra o guia da Square.
Square MCP
Pelo diretório do Claude
Chatfuel MCP no Claude

O que você precisa

  • Um bot do Chatfuel com um canal conectado. O caso dos pontos em dobro também precisa de uma conta do Instagram ou de uma página do Facebook, de onde saem as DMs dos comentários.
  • Uma conta da Square num país onde a Square aceita pagamentos com cartão: Estados Unidos, Canadá, Reino Unido, Irlanda, França, Espanha, Austrália ou Japão. Quem entra é o dono da conta ou alguém da equipe com permissão total.
  • Square Appointments Plus ou Premium para criar, remarcar ou cancelar agendamentos pela API; no plano gratuito, o assistente só lê. Para os pontos, o Square Loyalty com um programa criado no Square Dashboard.
  • O Claude, que tem a Square no diretório de conectores; o ChatGPT com developer mode para servidores MCP próprios; ou o Cursor com Node.js instalado.

Limites

  • A Square chama o servidor MCP de Beta e recebe sugestões e relatos de erro como issues do GitHub em square/square-mcp-server.
  • O servidor hospedado só acessa dados reais. A Square recomenda testar os prompts antes num Sandbox, o que exige o servidor local com um access token de Sandbox.
  • O agendamento do Chatfuel e o Square Appointments têm agendas separadas, e nada sincroniza as duas. Aqui o assistente agenda na Square quando você pede; os agendamentos que o Agente de IA faz no Chatfuel ficam no Chatfuel.
  • Com acesso de vendedor, o assistente pode marcar dois clientes no mesmo horário ou fora do expediente, por isso ele confere antes os horários livres da Square. Sem Plus ou Premium, a Square recusa qualquer mudança de agendamento com um 403.
  • A Square procura clientes por telefone ou e-mail, não pelo nome, e o Chatfuel MCP não passa nenhum dos dois. A cliente precisa digitar um deles na conversa; no caminho inverso, list_chats consegue buscar o telefone de um perfil da Square.
  • A Square não documenta uma etapa de aprovação própria para gravações como estornos, então mantenha a aprovação de tools ligada no assistente. Só dá para estornar pagamentos concluídos com até um ano, no máximo 20 vezes por pagamento.
  • Uma resposta ao cliente só sai depois que você aprova o texto e dentro do prazo: 24 horas desde a última mensagem dele no WhatsApp, 7 dias no Instagram e no Messenger.
  • A Square só aceita clientes MCP da lista de liberados. Um assistente fora dela não consegue entrar até a Square incluí-lo, depois de um pedido no fórum de desenvolvedores.

Perguntas frequentes

  • Sim, as duas coisas. A Block hospeda o servidor em https://mcp.squareup.com/mcp, e o guia da Square em developer.squareup.com/docs/mcp chama o servidor de Beta. O código da versão local está no GitHub como square/square-mcp-server. A Square não publicou o servidor no MCP Registry.

Conecte o Chatfuel MCP

Comece o teste grátis, adicione o Chatfuel ao seu assistente e pergunte sobre Square e as suas conversas em um só lugar.