**Com a API REST da Papo (https://papo.global/), você automatiza a criação, a listagem e o cancelamento de mensagens agendadas para WhatsApp e SMS, integrando o agendamento de comunicações diretamente aos seus sistemas, CRMs ou fluxos de automação — sem precisar acessar o painel manualmente.**

A plataforma Papo já oferece uma área centralizada para gerenciar mensagens programadas, mas quando o volume de agendamentos é alto ou quando você precisa que outro software dispare os envios, a API é o caminho. Com ela, é possível criar lembretes, follow‑ups e notificações de forma programática, mantendo o mesmo controle que você teria na interface visual.

## Resumo das operações de mensagens agendadas via API

| Operação | O que faz | Quando usar |
| :--- | :--- | :--- |
| Criar agendamento | Agenda uma mensagem de WhatsApp ou SMS para um contato em uma data e hora específicas. | Programar lembretes de consulta, follow‑ups de vendas ou notificações de cobrança a partir de um sistema externo. |
| Listar agendamentos | Retorna todas as mensagens agendadas, com possibilidade de filtrar por status (pendente, enviada, cancelada, falha). | Sincronizar a agenda de envios com um dashboard, verificar pendências antes de criar novos agendamentos ou auditar comunicações programadas. |
| Cancelar agendamento | Cancela um envio programado antes do horário de disparo. | Interromper uma mensagem que não é mais relevante, como um lembrete de evento cancelado ou um follow‑up que perdeu o sentido. |

## Como funciona a integração

A API da Papo segue o padrão REST e utiliza autenticação via token Bearer. Todas as operações de escrita (criação e cancelamento) exigem a chave secreta da sua conta, gerada na área de desenvolvedor do painel. A URL base é `https://app.papo.global/api/v1`.

Para usar os recursos de mensagens agendadas:

1. Gere uma chave secreta no painel da Papo (área de desenvolvedor/API). Guarde‑a em local seguro — ela é exibida apenas uma vez.
2. Em cada requisição, inclua o cabeçalho `Authorization: Bearer {sua_chave_secreta}`.
3. Utilize os endpoints específicos para mensagens agendadas, conforme a documentação oficial em [https://papo.global/pt/docs](https://papo.global/pt/docs). Lá você encontra os caminhos exatos, os parâmetros obrigatórios (como ID do contato, canal, conteúdo, data/hora) e exemplos de payload no formato JSON.
4. Para listar agendamentos, você pode aplicar filtros por status, permitindo consultar apenas os envios pendentes ou já concluídos.

A API reflete o comportamento do módulo **Mensagens Agendadas** da plataforma: os agendamentos criados via API aparecem na listagem do painel, e qualquer cancelamento feito pela API atualiza o status imediatamente.

## Para quem essa automação é indicada

- **Desenvolvedores e equipes de TI** que precisam integrar o agendamento de mensagens a sistemas próprios, como ERPs, CRMs ou plataformas de agendamento de consultas.
- **Revendedores white label** que desejam oferecer aos seus clientes a possibilidade de programar envios via API, ampliando o valor da solução.
- **Operações com alto volume de follow‑ups** (vendas, cobrança, confirmação de presença) que querem automatizar a criação de lembretes sem intervenção manual.
- **Empresas que utilizam fluxos de automação** e disparam a criação de agendamentos a partir de eventos em outras ferramentas.

## Perguntas frequentes

### Preciso ter o módulo de Mensagens Agendadas ativo para usar a API?
Sim. A API opera sobre a mesma funcionalidade que você encontra no painel. Se o módulo estiver disponível no seu plano, os endpoints correspondentes também estarão acessíveis.

### A API permite agendar mensagens com anexos ou mídia?
A documentação oficial detalha os tipos de conteúdo suportados. Atualmente, o agendamento via plataforma é voltado para mensagens de texto. Consulte a referência da API para verificar se há suporte a mídia no momento da sua integração.

### Como faço para autenticar as requisições?
Utilize a chave secreta da sua conta Papo como token Bearer no cabeçalho `Authorization`. A chave é gerada na área de desenvolvedor do painel.

### Posso agendar mensagens para vários contatos de uma só vez?
A API permite criar um agendamento por requisição. Para múltiplos contatos, você pode fazer chamadas sequenciais. Verifique na documentação se existem endpoints de lote para o seu caso de uso.

### O que acontece se eu tentar cancelar uma mensagem que já foi enviada?
A API retornará um erro, pois apenas agendamentos com status pendente podem ser cancelados. Após o disparo, a mensagem não pode mais ser alterada.

### Onde encontro as chaves de API?
No painel da Papo, acesse a área de desenvolvedor ou configurações de API. A chave secreta é exibida no momento da criação; se perdida, será necessário gerar uma nova.

## Leia também

- [Como gerenciar mensagens agendadas na Papo: editar, cancelar e visualizar](/hc/papo/articles/gerenciar-mensagens-agendadas-papo)
- [Como usar a API da Papo para listar conversas e enviar mensagens programáticas](/hc/papo/articles/usar-api-papo-listar-conversas-enviar-mensagens-programaticas)

---

**[Comece a automatizar seus agendamentos agora →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

Com a Papo, você integra WhatsApp, CRM e IA em um só lugar, sem custo inicial.