Chaves com escopos
12 escopos, como ler vendas, editar contatos, criar agendamentos, enviar WhatsApp e criar posts. A chave expira em 30, 90, 180 ou 365 dias, ou nunca, aparece uma única vez e pode ser rotacionada ou revogada.
Todas as integrações
Integração · API e webhooks
DisponívelLigue o Audiencer ao seu sistema com API e webhooks.
Uma chave por sistema, só com os escopos que ele precisa, para ler vendas, contatos e agenda e criar contatos, agendamentos, rascunhos de post e mensagens de WhatsApp. Os webhooks avisam o seu sistema na hora de cada lead, venda, agendamento ou mensagem.
Tela ilustrativa, com dados de exemplo.
O que o Audiencer faz
API e webhooks no mesmo painel do resto da sua operação.
API REST com OpenAPI
Produtos, propostas, carrinhos, checkouts, cobranças, assinaturas, contatos, conversas, agendamentos, chamados e análises, com a especificação OpenAPI para montar cada chamada. O escopo Operações roda as mesmas consultas e alterações do Conecte sua IA.
Webhooks de saída
Mais de 90 eventos de Atendimento, Contatos e leads, Agenda, Vendas, Contratos, Cursos, Ingressos, Treinos, Assinaturas, Lançamentos, Skills de IA, Redes sociais e Plano. Cada endereço escolhe os eventos e, se quiser, as contas conectadas.
Lista de entregas
Cada envio é assinado com HMAC-SHA256 no cabeçalho X-Webhook-Signature, pode levar até 8 cabeçalhos seus e fica na lista de entregas, com teste e reenvio.
O que entra no Audiencer
- Eventos no formato { id, event, timestamp, data }, com a marca em data.workspaceId.
- O que cada escopo libera: vendas, contatos e conversas, agenda, chamados, análises e auditoria.
- Registro de auditoria: chave criada, rotacionada ou revogada, webhook criado ou alterado, teste e reenvio.
Onde fica e como conecta
- Módulo
- Plano pago (qualquer módulo ou pacote)
- No painel
- Configurações › Integrações › API e webhooks.
- Conexão
- Chave de API da marca no cabeçalho X-API-Key; os webhooks de saída mandam os eventos para um endereço https seu.
Limites, sem letra miúda
- Só o dono e os administradores da marca criam chaves e webhooks.
- Webhook só para endereço https público, com até 10 endereços por marca e até 64 eventos em cada um.
- Cada entrega tem até 3 tentativas: na hora, depois de 1 minuto e depois de mais 2. O Audiencer espera a resposta por até 30 segundos.
- O escopo Operações segue os limites diários do Conecte sua IA.
Perguntas frequentes
API e webhooks no Audiencer, em respostas curtas.
Onde está a documentação?
Na especificação OpenAPI em /api/smartcast-social/v1/openapi.json, com cada rota, o escopo que ela pede e o formato dos eventos. O link fica em Configurações › Integrações › API e webhooks.
Como confiro que o webhook veio do Audiencer?
Cada envio traz X-Webhook-Signature: t=<unix>,v1=<HMAC-SHA256 de "t.corpo">, feito com o segredo do endereço. O segredo aparece uma única vez e pode ser regenerado.
Quais eventos existem?
Mais de 90: mensagem recebida e enviada no Atendimento, lead e contato novos, etiqueta, agendamento, venda paga, carrinho abandonado, assinatura, matrícula, ingresso, post publicado, comentário e menção, entre outros. A API devolve um exemplo do corpo de cada evento.
Combina com