**Sim, você pode gerenciar serviços, horários e agendamentos via API usando o módulo de Atendimentos da [Papo](https://papo.global/). 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

1.  Acesse a área de desenvolvedor/API no painel da Papo e gere uma chave secreta. Copie também a chave pública da conta.
2.  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.
3.  **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.
4.  **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.
5.  Consulte a documentação oficial em `https://papo.global/pt/docs` para 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](/hc/papo/articles/usar-api-papo-criar-atualizar-contatos-massa)
- [Como usar a API da Papo para criar e gerenciar etiquetas (tags)](/hc/papo/articles/como-usar-api-papo-criar-gerenciar-etiquetas-tags)

---

**[Comece a integrar sua agenda via API →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-usar-api-papo-gerenciar-atendimentos-agendamentos&utm_content=pt_BR)**

Cadastre-se na Papo e tenha acesso à API REST para automatizar seus agendamentos a partir do primeiro usuário.