Documentação oficial

Do primeiro acesso à campanha concluída.

Um guia prático para conectar sua conta, organizar públicos, agendar envios e acompanhar cada resultado com segurança.

Primeiros passos

  1. Crie a conta e confirme seu e-mail.
  2. Escolha o plano mensal ou adicione créditos pré-pagos.
  3. Conclua o Pix. A confirmação e o provisionamento podem ser acompanhados no painel.
  4. Abra Conexões, leia o QR local e aguarde o estado “online”.
  5. Sincronize Públicos e grupos e bloqueie destinos que não devem receber campanhas.
  6. Crie uma campanha, confira custo e recorrência, envie um teste controlado e só então ative.
Uma indisponibilidade temporária não perde o pagamento: o provisionamento fica na fila segura e é conciliado automaticamente.

Campanhas

Conteúdo

Texto e mídias validadas por tipo real, tamanho e assinatura. Arquivos permanecem privados e usam URL temporária.

Destinos

Grupos, contatos normalizados e listas de exclusão sempre isolados por conta e conexão.

Agenda

Horário no fuso de São Paulo, recorrência diária ou semanal e uma única execução por janela.

Resultado

Enviados, falhas, pendentes, custo cobrado e resultado individual sanitizado.

Estados

Rascunho ainda não agenda; Ativa gera execuções; Pausada cancela pendências; Concluída terminou a janela; Revisão indica resultado anterior incerto e nunca é reenviado automaticamente.

Cobrança e créditos

O Pix é criado pela AtivoPay. A confirmação só ocorre depois de consultar a transação autenticada e comparar referência, valor, moeda, método e estado. O identificador público da cobrança é usado nas consultas.

  • Plano mensal inicial: R$ 69,90, administrável no painel.
  • Recarga mínima: R$ 10,00.
  • Custo pré-pago inicial: R$ 0,25 por destino, versionado no banco.
  • Webhooks repetidos produzem apenas uma ativação ou crédito no razão.
  • Cancelar a renovação preserva o acesso até o fim do período vigente.

Limites, consentimento e opt-out

Use apenas públicos com base legal e consentimento compatível com a finalidade. A lista de supressão tem prioridade sobre campanhas e não pode ser contornada.

  • Números são normalizados no padrão E.164 e deduplicados antes da cobrança.
  • Intervalos são serializados por conexão; várias campanhas não multiplicam a velocidade.
  • Destinos suprimidos, conexão offline, assinatura vencida ou usuário suspenso cancelam a fila pendente.
  • Respeite horário permitido, frequência razoável e pedido de descadastro imediatamente.

Erros e recuperação

CódigoSignificadoAção
401Sessão ou credencial ausenteAutentique novamente; nunca repita com dados antigos.
402Plano ou saldo indisponívelRegularize a cobrança e aguarde a conciliação.
403Operação não autorizadaConfirme proprietário, papel administrativo e CSRF.
409Conflito ou resultado incertoConcilie antes de repetir para evitar duplicidade.
422Dados inválidosCorrija os campos indicados.
429Limite temporárioAguarde o Retry-After.
502/504Integração indisponível ou timeoutO worker fará backoff; não crie uma nova operação manualmente.

Segurança

Cookies seguros, CSRF em mutações, rate limit persistente, criptografia Sodium para credenciais, segregação por proprietário, auditoria administrativa e autenticação em dois fatores para administradores fazem parte do fluxo. O painel e os eventos externos nunca retornam tokens de conexão nem detalhes da infraestrutura.