Sim, você pode gerenciar serviços, horários e agendamentos via API usando o módulo de Atendimentos da Papo. A API REST permite que você liste serviços, profissionais e pacientes, consulte a agenda e crie novos agendamentos de forma programática, integrando todo o fluxo de marcações ao seu site, aplicativo ou sistema externo.
O módulo de Atendimentos da Papo foi projetado para ser o centro de controle da sua agenda. Ele organiza quatro pilares: os serviços que você oferece (com nome, duração e preço), os profissionais que os executam, a disponibilidade de horários de cada um e os agendamentos realizados. Com a API, você pode automatizar essas operações sem acessar o painel manualmente, mantendo uma integração fluida entre a Papo e suas outras ferramentas.
Resumo das operações de Atendimentos via API
| Operação | O que faz | Quando usar |
|---|---|---|
| Listar serviços | Retorna os serviços de atendimento cadastrados, com duração e preço. | Sincronizar catálogo de serviços com seu site ou aplicativo para que o cliente veja as opções em tempo real. |
| Listar profissionais | Retorna a lista de atendentes ou membros da equipe que realizam os serviços. | Exibir os profissionais disponíveis e suas especialidades em uma interface externa de agendamento. |
| Listar pacientes | Retorna os pacientes cadastrados, com nome, telefone e ID. | Verificar se um cliente já existe no CRM antes de criar um novo agendamento ou vinculá-lo a um registro existente. |
| Listar agendamentos | Retorna os agendamentos com filtro por status (ex.: confirmado, pendente). | Auditar marcações, integrar com sistemas de relatório ou verificar a ocupação da agenda antes de oferecer novos horários. |
| Agendar um atendimento | Cria um agendamento real na agenda de um profissional, para um serviço e paciente específicos. | Permitir que clientes agendem diretamente pelo seu site ou aplicativo, ou automatizar a criação de marcações a partir de sistemas externos. |
Como funciona a autenticação da API
Todas as operações de escrita nos Atendimentos exigem a chave secreta da sua conta Papo, enviada como token Bearer no cabeçalho de autorização. A chave pública da conta é opcional, mas, se enviada, deve corresponder à mesma conta da chave secreta.
A URL base da API é https://app.papo.global/api/v1. As chaves são geradas na área de desenvolvedor do painel da Papo. A chave secreta é exibida uma única vez na criação; guarde-a em local seguro e a revogue imediatamente se houver suspeita de vazamento.
Como usar na prática
- Acesse a área de desenvolvedor/API no painel da Papo e gere uma chave secreta. Copie também a chave pública da conta.
- Em cada requisição, autentique com a chave secreta como token Bearer. Se quiser reforçar a validação, envie a chave pública no cabeçalho indicado na documentação.
- Para montar a interface de agendamento, primeiro liste os serviços e profissionais disponíveis. Assim, você pode popular dinamicamente as opções no seu site ou app com os dados reais da sua conta Papo.
- Para criar um agendamento, chame o endpoint de criação de atendimento, enviando no payload JSON os identificadores do serviço, do profissional, do paciente e a data/hora desejada. A API validará a disponibilidade na agenda configurada no módulo de Atendimentos e criará o compromisso.
- Consulte a documentação oficial em
https://papo.global/pt/docspara obter os caminhos exatos, os parâmetros obrigatórios e exemplos de código. Todas as respostas são no formato JSON.
A API também permite listar os agendamentos existentes com filtro por status. Isso é útil para construir painéis de acompanhamento, enviar lembretes automáticos ou integrar o status das marcações com outros sistemas.
Para quem essa integração é indicada
- Clínicas, consultórios e salões de beleza que desejam oferecer agendamento online no próprio site, com disponibilidade em tempo real.
- Plataformas SaaS e marketplaces que precisam conectar a agenda dos prestadores de serviço a um sistema externo de reservas.
- Revendedores white label que criam soluções personalizadas para clientes finais e querem expor o módulo de Atendimentos via API.
- Empresas com fluxos automatizados que disparam a criação de agendamentos a partir de eventos em CRMs, ERPs ou ferramentas de automação.
Perguntas frequentes
Preciso ter o módulo de Atendimentos configurado para usar a API?
Sim. É necessário que os serviços, profissionais e suas disponibilidades já estejam cadastrados no módulo de Atendimentos da Papo para que a API possa listá-los e validar os agendamentos.
A API permite criar um novo serviço ou profissional?
Os recursos da API focam em listar serviços e profissionais existentes e agendar atendimentos. Para criar ou editar serviços e profissionais, utilize o painel da Papo.
Como a API sabe se um horário está livre?
Ao enviar uma requisição para agendar um atendimento, a API da Papo consulta a disponibilidade configurada para o profissional e o serviço escolhido naquele dia e horário. Se houver conflito, o agendamento não será criado e a API retornará um erro.
Posso usar a API para agendar um atendimento em nome de um paciente que ainda não está no CRM?
Você pode primeiro usar a API de Contatos da Papo para criar o paciente (com nome, e-mail e/ou telefone) e, em seguida, usar o ID retornado para criar o agendamento. Consulte a documentação para o endpoint de criação de contatos.
A IA da Papo pode agendar automaticamente via API?
A Inteligência Artificial da Papo, como o Super Chat, agenda diretamente pela conversa no WhatsApp, consultando a agenda do módulo de Atendimentos. A API é o caminho para integrações programáticas externas, como um sistema de agendamento online.
Onde vejo o formato exato do payload para agendar?
Na documentação oficial da API, em https://papo.global/pt/docs. Lá estão os detalhes de autenticação, parâmetros, respostas e exemplos de código para os recursos de Atendimentos.
Leia também
- Como usar a API da Papo para criar e atualizar contatos em massa
- Como usar a API da Papo para criar e gerenciar etiquetas (tags)
Comece a integrar sua agenda via API →
Cadastre-se na Papo e tenha acesso à API REST para automatizar seus agendamentos a partir do primeiro usuário.