Changelog

​

Melhorias

​

Novidades

• WhatsApp, Telegram (modo usuário) e Instagram: generateShareableLink: true na criação devolve um link para o cliente finalizar a conexão no navegador, sem QR ou login Meta no seu servidor.
• Telegram (modo usuário): o create já inicia o QR e devolve connection.base64 / loginUrl.
• Instagram: sem auth no create, gera rascunho PENDING + link para login remoto.
• Gestão do link via API: GET/POST .../instances/{id}/connect-page (status, ativar, rotacionar secret, desativar).

• Em WhatsApp, SMS, e-mail, push, Telegram, Instagram, RCS e voz: type: "template" + payload.templateId envia só aquele canal do template.
• WhatsApp oficial: exige template aprovado pela Meta; conexão por QR: conteúdo simples na sessão (sem header ou botões Meta).
• Fan-out multicanal continua em POST /v1/templates/send.

​

Melhorias

• Campo mode em instâncias: UNOFFICIAL (QR) ou OFFICIAL (Embedded Signup). Listagem, consulta e criação devolvem mode.
• Oficial com link compartilhável: omita os campos Meta no payload e use o flag para criar rascunho; o cliente conclui no link.
• Envio oficial: validações de token, template e mídia antes de enfileirar, com erros claros (META_TOKEN_EXPIRED, META_PERMISSION_DENIED, TEMPLATE_NOT_ALLOWED_FOR_INSTANCE).
• Campo metaName nos templates oficiais: nome usado no envio (o sync preenche automaticamente).
• Sandbox (sk_test_): envios WhatsApp e templates não chamam a Meta nem marcam a linha real como desconectada.
• Reconexão Embedded: ALREADY_CONNECTED só quando a linha está ativa com token válido.
• Rotação do secret do link invalida o link anterior.

​

Novidades

• Criação no painel: WhatsApp → Nova instância → Oficial → Embedded Signup (WABA + número).
• Na API: mode: "OFFICIAL" em POST /v1/whatsapp/instances (Embedded Signup; quando o recurso estiver habilitado no ambiente).
• A Meta cobra as conversas na conta do cliente; a Notifique cobra só a taxa de software da plataforma (ver tabela de cobrança nos docs).
• É obrigatório ter cartão ativo no WhatsApp Manager. Sem pagamento, o envio bloqueia com META_PAYMENT_METHOD_REQUIRED.
• Fora da janela de 24h, só template oficial aprovado; dentro da janela, texto/mídia de sessão.
• Credenciais manuais (OFFICIAL_BYOK) ficaram em segundo plano no onboarding, prefira Embedded Signup (OFFICIAL).

• Catálogo na WABA (vários números da mesma conta compartilham templates).
• Sync pull/push com a Meta; status por webhook (APPROVED, PENDING, REJECTED, …).
• Templates internos Notifique continuam com source: ZENVIO; oficiais usam source: WHATSAPP_OFFICIAL.
• Template APPROVED na Meta: limite de edição 1× a cada 24h e 10× a cada 30 dias (regra da Meta).

• Atalho de Configurações do canal no WhatsApp (e demais canais): resumo das instâncias e ajustes de mensagens recebidas (receber / salvar / webhook) no mesmo espírito da aba Mensagens recebidas do workspace.

• No Inbox e no detalhe da mensagem recebida: transcrever áudio (WhatsApp, Telegram, Instagram) sob demanda, com cobrança em crédito.
• Opção de transcrever automaticamente nos ajustes de inbound do usuário.

​

Melhorias

• Abaixo da timeline: abas Mensagem / Metadata / Eventos (segmented control compacto, sem card envolvendo tudo).
• Mensagem, conteúdo e histórico de edições/respostas.
• Metadata, metadata da requisição (e payload do provedor, quando houver).
• Eventos, entregas de webhook que aquela mensagem acionou (com link para a chamada).
• Preview de mensagens estruturadas (template, botões, lista, respostas interativas) no detalhe WhatsApp enviado e recebido.

• Token Meta expirado ou inválido: a instância passa a DISCONNECTED e o painel pede reconexão.
• Link compartilhado de conexão respeita o mesmo modo de reconexão da linha (Embedded Signup ou token legado).
• Cloud API não edita nem apaga mensagem já enviada: API responde META_MESSAGE_EDIT_UNSUPPORTED / META_MESSAGE_DELETE_UNSUPPORTED; o painel esconde Editar/Excluir na linha oficial.

​

Melhorias

• Download inbound agora inclui video e sticker (além de image/audio/document), via instância QR / não oficial.
• Endpoints: POST /v1/whatsapp/messages/inbound/{id}/media e GET .../media/download.

• Novos endpoints: POST /v1/telegram/messages/inbound/{id}/media e GET .../media/download (escopo telegram:read).
• GET .../inbound/{id} passa a retornar contentPreview e mediaFetch.
• Tipos: image, audio, video, document, sticker. Bot usa getFile; User usa MTProto downloadMedia.

• Novos endpoints: POST /v1/instagram/messages/inbound/{id}/media e GET .../media/download (escopo instagram:read).
• GET .../inbound/{id} com contentPreview e mediaFetch.
• Tipos: image, video e audio/voice (URL no payload; voice com fallback aiograpi).

​

Melhorias

• Templates MARKETING (sempre headers; rodapé HTML continua opcional via appendPreferencesLink), campanhas e automações.
• POST /v1/email/messages: ligado por padrão quando o destinatário é um contato; use listUnsubscribe: false em transacional.
• Endpoint público: GET só confirma (sem mutar, evita scanners); POST aplica opt-out (List-Unsubscribe=One-Click ou formulário).
• Tópico inválido na URL não faz fallback para opt-out global; listUnsubscribeTopicId inválido na API retorna 400 INVALID_LIST_UNSUBSCRIBE_TOPIC.
• Guia: One-click unsubscribe (RFC 8058). Erro: Respostas de erro.

​

Melhorias

• ~1.150 respostas success: false revisadas em WhatsApp, Instagram, SMS, e-mail, Telegram, push, RCS, voz, webhooks, CRM, contatos, templates, automações, links curtos e mais.
• Campos obrigatórios em erro: error (rótulo HTTP), message (texto legível), code (enum).
• Middleware global: UNAUTHORIZED, API_KEY_EXPIRED, API_KEY_REVOKED, RATE_LIMIT_EXCEEDED, ONBOARDING_REQUIRED, WORKSPACE_HEADER_NOT_ALLOWED.
• Novos códigos de negócio comuns: WEBHOOK_NOT_FOUND, EMAIL_DOMAIN_NOT_FOUND, INSTANCE_CAPACITY_FULL, VOICE_*, NO_MEDIA, DOWNLOAD_FAILED, etc.
• POST /v1/report (denúncias FELCA) e download de mídia WhatsApp inbound passam a incluir code em todos os erros.

• DNS pendente: HTTP 200, success: true, verified: false, code: EMAIL_DOMAIN_DNS_PENDING
• Verificado: EMAIL_DOMAIN_VERIFIED
• Falha DNS: EMAIL_DOMAIN_VERIFY_FAILED
• Erros HTTP com message localizada e code específico

{
  "success": true,
  "verified": false,
  "code": "EMAIL_DOMAIN_DNS_PENDING",
  "message": "Os registros DNS ainda não foram verificados. Confira no seu provedor DNS e tente novamente em alguns minutos.",
  "data": { "id": "clxx...", "domain": "seudominio.com", "status": "PENDING" }
}

{
  "success": false,
  "error": "Forbidden",
  "message": "Escopo ausente: whatsapp:send",
  "code": "FORBIDDEN"
}

​

Novidades

• GET /v1/whatsapp/messages/inbound/{id}/media/download, retorna o arquivo binário com Content-Type e Content-Disposition (ideal para curl -o e scripts).
• POST /v1/whatsapp/messages/inbound/{id}/media, body vazio; retorna JSON com data.base64 (ideal para integrações que já decodificam em memória).
• O tipo (image | audio | document) é inferido no servidor a partir do contentPreview.
• Escopo: whatsapp:read (respeita instanceIds da API Key).
• Requer instância não oficial (QR) ativa.

curl -L -H "Authorization: Bearer sk_live_..." \
  -o recebido.ogg \
  "https://api.notifique.dev/v1/whatsapp/messages/inbound/clxxinbound001/media/download"

{
  "success": true,
  "data": {
    "contentType": "audio/ogg",
    "fileName": "audio.ogg",
    "base64": "..."
  }
}

​

Melhorias

• Sucesso (200) e o corpo com registros DNS não mudaram.
• Em erro, prefira tratar pelo code (use message para exibir ao usuário final).
• Bloqueio antispam do provedor passa a retornar 422 em vez de 502.

​

Melhorias

• expectedUsername (opcional) em POST /v1/instagram/instances
• GET /v1/instagram/instances/:id expõe lockedUsername, lockedIgUserPk, reconnectBlockedUntil, abusePausedUntil, firstConnectedAt e objeto warmup (active, dailyLimit, sentToday, daysRemaining)
• Lock de conta: uma instância = um username após o primeiro login. Troque de conta criando nova instância.
• Cooldown de 12 h após disconnect involuntário + máx. 3 logins/hora. Desconexão manual via API não aplica cooldown.
• Pause por abuso quando o Instagram sinaliza rate-limit / restrição.
• Warm-up: até 15 DMs/dia nos primeiros 5 dias (instâncias novas).

​

Avisos para integrações

​

Melhorias

• expectedPhoneNumber (opcional) em POST /v1/whatsapp/instances, valida o número no primeiro pareamento.
• GET /v1/whatsapp/instances/:id expõe lockedPhoneNumber, reconnectBlockedUntil e objeto warmup (active, dailyLimit, sentToday, daysRemaining).
• Vínculo permanente: uma instância = um número após a primeira conexão. Troque de chip criando nova instância.
• Cooldown de 6 h após desconexão involuntária (ban, sessão derrubada). Desconexão manual via API não aplica cooldown.
• Warm-up: até 20 mensagens/dia nos primeiros 3 dias após firstConnectedAt (instâncias novas).

​

Avisos para integrações

​

Melhorias

{
  "to": ["..."],
  "type": "text",
  "payload": { "message": "..." },
  "schedule": { "sendAt": "ISO" }
}

{ "success": true, "data": { "messageIds": ["..."], "status": "QUEUED", "count": 1 } }

• to é sempre array, nunca string. Máximo 100 destinatários por requisição.
• status sempre MAIÚSCULO, QUEUED, SCHEDULED, SENT, DELIVERED, FAILED.
• messageIds é o campo canônico na resposta. Aliases por canal (smsIds, emailIds, etc.) continuam por compatibilidade.

​

Novidades

• GET /v1/rcs/messages, listagem de mensagens RCS.
• POST /v1/notify, envio multi-canal em uma chamada (inclui Instagram).
• POST /v1/templates/send, suporte ao canal Instagram (instagram.instanceId).
• MCP Notifique, novas tools para RCS, Voz e Instagram Direct.

​

Compatibilidade

​

Novidades

• Login com usuário e senha (2FA / desafio quando o Instagram pedir); acceptInstagramTerms obrigatório.
• Conteúdo: texto e mídia por URL HTTPS (imagem, vídeo, áudio, documento).
• Editar mensagem (até 1000 caracteres, 15 min, 5 edições) e unsend quando permitido.
• Comentários: listar, responder e apagar (instagram:comments:reply, instagram:comments:moderate).
• Escopos: instagram:send, instagram:read, instagram:cancel, instagram:update, instagram:delete e instâncias.

​

Melhorias

• RCS: rcs:send, rcs:read, rcs:cancel
• Conversões (Smart Links): conversions:manage
• WhatsApp grupos: whatsapp:groups (com add-on ativo)
• Instagram: instagram:update junto aos demais escopos do canal

​

Segmentos mais poderosos

​

Novos tipos de regra

• contactField: campos de plataforma (name, phone, email, url, telegramPeer, languages, hasPhone, hasEmail, hasUrl, hasTelegram)
• topic: inscrito ou não em um tópico (topicId + subscribed)
• Mantidos: tag, property (campos personalizados) e receiveMarketing

​

Operadores tipados (op)

​

Preview

​

Novo canal: voz e números de telefone

​

Números de telefone

• Contratação pelo painel: busque números disponíveis por país/DDD, reserve e pague a mensalidade recorrente
• API v1: GET /v1/phone-numbers, GET /v1/phone-numbers/available, GET /v1/phone-numbers/{id} e PATCH /v1/phone-numbers/{id} para consultar e configurar voz de entrada
• Comportamento inbound: encaminhar (FORWARD), TTS e desligar (TTS_HANGUP), rejeitar, caixa postal ou controle via webhook (WEBHOOK_CONTROL)
• Escopos: phone_numbers:read, phone_numbers:update

​

Voice API

• Originar chamadas: POST /v1/voice/calls com TTS, áudio por URL, coleta DTMF, gravação e detecção de caixa postal
• Acompanhar: GET /v1/voice/calls e GET /v1/voice/calls/{id} (com includeEvents=true)
• Controlar sessão: POST /v1/voice/calls/{id}/actions/{action} (speak, play, gather, transfer, record-start, record-stop, dtmf, hangup)
• Gravações: download via GET /v1/voice/calls/{id}/recordings/{recordingId}/download
• Escopos: voice:call, voice:read, voice:control
• Cobrança: por minuto de voz (pague pelo uso ou créditos do plano)

​

Webhooks

• Chamadas: voice.call.initiated, voice.call.received, voice.call.ringing, voice.call.answered, voice.call.completed, voice.call.failed, voice.call.dtmf, voice.call.gather.ended, voice.call.recording.ready, voice.call.machine.detected
• Números: phone_number.activated, phone_number.past_due, phone_number.suspended, phone_number.released

​

Novidades

• Fila única com status (Aberta, Pendente, Resolvida), responsável e filtros por canal
• Atribuir conversa manual ou automaticamente; resolver e reabrir
• Roteamento: automação/IA, aguardando colega ou humano ativo
• Métricas: primeira resposta, resolução, conversas sem responsável
• Responder com texto, template ou imagem por URL; painel lateral com resumo IA e link ao contato

​

Melhorias

​

Avisos

1. Configurações → API Keys → nova chave com escopos necessários.
2. Troque na aplicação e revogue a antiga quando estável.
3. Ou Editar a chave atual e definir escopos explicitamente.

​

Novidades

​

Melhorias

• Agendar envio (scheduledFor) e cancelar agendamento
• Lista com status legíveis e mini-resumo enviados · entregues · falhas
• KPIs, funil por canal, timeline e lista de destinatários (painel e API)
• UTMs automáticos (utm_campaign, utm_content) em links da campanha

​

Vários números trabalhando juntos

• Estratégias de distribuição: rodízio, por peso (números “mais fortes” mandam mais) ou menor uso (quem enviou menos hoje é o próximo)
• Proteções automáticas: pausa por falhas consecutivas (circuit breaker), cooldown entre lotes, limite diário por número e monitoramento de saúde no painel
• Retrocompatível: se você escolher instanceId ou número específico na API ou no painel, nada muda; sem número definido, usa o pool padrão do workspace
• Campanhas: escolha um pool no editor para distribuir todos os destinatários entre os números do grupo

​

Ficha do contato mais completa

• Visão geral: dados, tags, tópicos, segmentos e inteligência operacional
• Timeline: histórico cronológico unificado: envios e recebidas (WhatsApp, SMS, e-mail, Telegram, widget web), automações, notas, tarefas, mudanças no funil e insights de IA
• Notas: anotações internas da equipe, com opção de fixar as mais importantes
• Tarefas: follow-ups com título, prazo, responsável e status (aberta/concluída)
• Conversas: todas as threads do inbox ligadas ao contato, com link direto para cada uma

​

Perfil IA de relacionamento

​

Funil kanban (pipeline)

​

Conecte Gmail, Outlook, Drive e mais ao assistente

• Gmail, Google Calendar, Google Drive (OAuth)
• Outlook (e-mail e calendário), SharePoint, Microsoft Teams, Dropbox
• Servidor MCP customizado (HTTPS) com token ou headers próprios

​

Checkpoint de aprovação nos fluxos

​

Chat com IA no canto do seu site

• Instalação simples: copie o snippet <script> do painel e cole no site; preview ao vivo enquanto personaliza cores, posição, textos de boas-vindas e perguntas sugeridas
• Domínios autorizados: o widget só funciona nos hosts que você permitir
• Identificação do visitante: modos anônimo, opcional (nome/e-mail/telefone) ou obrigatório; quem preenche vira contato no CRM automaticamente
• Verificação por código OTP: opcional: envia código de 6 dígitos por e-mail, SMS ou WhatsApp antes de liberar a conversa (consome créditos de envio)
• Login no site (HMAC): se o visitante já está logado no seu site, o backend pode assinar a identidade sem formulário nem OTP
• Handoff humano: conversas entram no Inbox como canal Widget IA; pode transferir para atendente; visitante pode disparar automações

​

Onboarding que entende o seu negócio

​

Limites de instâncias e expiração de plano mais claros

• Limites por canal: WhatsApp e Telegram têm cotas separadas (ex.: Pro = 2 de cada); o wizard de criação de instância e a página de planos deixam isso explícito
• Expiração automática: quando a assinatura paga expira, o workspace é rebaixado automaticamente (sem depender de ação manual)
• Data de expiração visível: planExpiresAt aparece na assinatura e nas configurações do workspace, com mensagens de trial/período de teste na página de assinatura
• Ao tentar exceder o limite do plano, o bloqueio é claro na API e no painel

​

Sincronize o histórico do WhatsApp

​

Responder com mais recursos no inbox

• Templates (WhatsApp, SMS, Telegram) com preview de variáveis: enviar direto ou colocar no campo de texto
• Imagem por URL (WhatsApp e Telegram)
• Tags IA padronizadas no painel lateral (ex.: “cliente frustrado”, “alta intenção”)

​

Extrato detalhado de créditos e saldo

​

Ferramentas WhatsApp Link

• Ajustar privacidade da conta (último visto, foto, grupos etc.)
• Importar contatos da agenda WhatsApp para o CRM

​

Webhook por automação

​

Esperar sinal e condições mais ricas

• Esperar sinal: o fluxo pausa até acontecer algo: e-mail aberto, recibo de leitura no WhatsApp ou evento registrado da automação, com ramo de timeout opcional (ex.: “mandou e-mail → espera abrir → manda follow-up”)
• Condições numéricas: além de “igual” e “contém”, compare números com maior que, menor que, maior ou igual, menor ou igual (valores de pedido, quantidades, scores)
• Gatilho por mensagem recebida: automações disparam quando chega mensagem inbound (WhatsApp, Telegram etc.), não só por eventos internos

​

Encontre contatos com precisão

• Por tópicos (topicIds), segmento (segmentId) e propriedades customizadas (propertyFilters)
• Filtros por marketing, presença de URL/Telegram e combinações de regras
• UI de filtros avançados no painel com busca segmentada, feedback visual de carregamento e colunas configuráveis

​

Editor de e-mail mais fiel ao HTML original

​

Bases de conhecimento (RAG) por workspace

​

Assistentes configuráveis

​

Assistente de IA no painel

​

Conexões mais estáveis

​

CRM e campanhas

• Nova aba Tags de audiência no CRM para criar e gerenciar tags de contatos
• Confirmação antes de disparar campanha, com preview da audiência
• Preview rico de mensagens WhatsApp recebidas (texto, mídia, botões) na API e na tela de detalhe do inbound
• Editor de templates mais capaz (comandos /, sidebar, canvas por canal)
• Página de contatos reorganizada com melhor UX de listagem e filtros

​

WhatsApp com conexão mais estável

​

Painel em português, inglês e espanhol

​

Rastreie cliques nos links que você envia

​

O que você precisa fazer

• Em Configurações do workspace, ative links curtos e, se quiser, marque converter links automaticamente nos envios.
• No add-on de links curtos, você também pode criar links na mão e ver a lista dos mais recentes.

​

Webhook quando alguém clica no link curto

​

Status CLICKED no envio (além do e-mail)

​

Lançamos o modo sandbox na API e no painel

• Documentação: Sandbox mode
• Blog: Ambiente sandbox: testar integração sem enviar SMS (nem e-mail) de verdade

​

Editor de fluxos mais completo e previsível

• Encerrar fluxo (endFlow): passo terminador: não envia nada e não tem saída; serve para fechar um ramo (por exemplo “senão” de uma condição) sem pendurar mais nada. O motor grava o passo como concluído e segue a regra normal de fim de run quando não há mais passos pendentes.
• Condição em gatilho por mensagem recebida: quando o gatilho é inbound (WhatsApp, Telegram ou SMS), a condição compara o texto da mensagem (body / bodyPreview / preview) com operadores como igual, contém, começa com, etc. Não há “fonte evento vs contato” nesse modo: só o texto recebido. Em gatilho por evento da API, a condição continua podendo olhar payload do evento ou dados do contato (com campo / path obrigatório).
• Condição dentro de condição: dá para colocar outra condição a partir do + do ramo Verdadeiro ou Falso (antes o painel só permitia passos “lineares” ali). Isso permite regras mais granulares em sequência.
• Sempre dois ramos: depois de apagar passos (por exemplo uma condição intermediária), o editor garante que cada condição continue com saída Verdadeiro e Falso; se faltar um lado, volta a aparecer o placeholder (+) para você escolher o próximo passo: evita fluxo “quebrado” com só um braço.
• Esperas curtas corretas: ajuste no motor de filas para delays não serem executados antes da hora. Hoje o agendamento respeita o horário devido com promoção periódica da fila de automação.

​

Envio de push mais barato no saldo em reais

​

Um ecossistema de automações

​

Exemplos do dia a dia

• Boas-vindas e depois dicas: Envie um e-mail de boas-vindas assim que o evento acontecer e, alguns dias depois, outro e-mail com dicas. Basta colocar um passo de espera (por exemplo 3 dias) entre os dois envios.
• Conteúdo diferente por plano: Use uma condição em cima de um dado do contato ou do evento (por exemplo plano gratuito ou pago) e ramifique o fluxo: um caminho envia um tipo de mensagem, o outro caminho envia outro: cada público recebe o que faz sentido.
• Só avançar depois da integração: Monte a sequência para que a próxima mensagem só venha depois que a pessoa tiver tempo de concluir um passo importante (como terminar a integração). Você combina esperas e o que acontece no evento ou no contato para não apressar a jornada e melhorar a experiência.

​

Mensagens que chegam para você: mais claro no painel e nos webhooks

​

Regras nas mensagens recebidas

​

Histórico do template: ver o passado e voltar com segurança

​

Testar o template antes de usar de verdade

​

Vários idiomas, variáveis e IA no mesmo template

​

Idiomas preferidos no contato (CRM)

• Painel: edite idiomas na ficha do contato (detalhe do CRM).
• API e envios: WhatsApp, SMS, e-mail, push, RCS, Telegram e templates passam a considerar languages do contato ao resolver texto por destinatário.

​

Analytics e performance individual do contato

• Insights: resumo com score de engajamento, nível (alto/médio/baixo) e bullets acionáveis.
• Gráficos e canais: leitura de volume e desempenho ao longo do tempo, com recorte por canal quando aplicável.
• Contexto para o time: menos “achismo”: abre o contato e vê se ele responde, em quais canais interage mais e como isso evolui.

​

Localização de mensagens: manual, automática (IA) e desligada

• Desligada: um único texto para todos (comportamento clássico).
• Manual: você envia um objeto i18n (JSON por locale) com traduções já prontas; o backend escolhe o bloco certo usando sourceLocale + idiomas do contato.
• Automática (IA): o texto base é traduzido por modelo (OpenAI ou API compatível), com regras rígidas para preservar placeholders ({{nome}}, etc.) e HTML em e-mails; se a IA falhar ou não estiver configurada, há fallback para o texto base.
• Custo: no modo IA, a cobrança segue a política do produto (por destinatário traduzido); o painel indica quando o envio usa idiomas do CRM.

​

Templates: traduções por locale

​

Benefícios em conjunto

​

Envio: prioridade, webhook por lote e metadata

• options.priority: fila prioritária de entrega da mensagem (e, quando aplicável, fila prioritária de webhooks).
• options.webhook: URL HTTPS (e secret opcional) para receber só os eventos daquele envio, no mesmo formato dos webhooks cadastrados.
• metadata: pares string→string persistidos no registro do envio (por canal).

​

Denúncias públicas e Platform Status

• POST /v1/report: endpoint público para denúncias (FELCA); documentação em API de denúncias.
• Platform Status: super admins veem as últimas denúncias recebidas, com detalhes ao clicar na linha.

​

Novo canal: Telegram

• Dois modos de conexão:
  • Bot: cadastro com token do @BotFather.
  • Conta de usuário: fluxo de login com QR ou string de sessão após aceite dos termos no painel.
• API v1: envio de texto, mídia por URL, localização (localização apenas no modo bot, conforme suporte atual); listagem e detalhe de mensagens; cancelar, editar texto e apagar quando o Telegram permitir; listagem e detalhe de atividade recebida.
• Dashboard: criar e gerir instâncias Telegram, assistir ao fluxo de QR/sessão e acompanhar envios e recebidas no painel.
• Documentação: guia dedicado Telegram API.

​

API de contatos e audiência (v1)

​

Regras de segmento: campo personalizado com “contém” e ignorar maiúsculas

• valueMatch: exact (padrão, comportamento anterior) ou contains (substring no valor salvo).
• ignoreCase: true para comparar sem diferenciar maiúsculas/minúsculas.

​

Contatos e Audiências: Topics, Segments e Campaigns

• Custom fields (contact properties): definição de campos personalizados para enriquecer contatos e personalizar envios.
• Topics e preferências públicas: criação de tópicos de comunicação com página pública de preferências para opt-in/opt-out do usuário final.
• Segments com DSL: criação de segmentos dinâmicos com preview de contatos antes do disparo.
• Campaigns com execução em pipeline existente: disparos em lote reaproveitando o pipeline atual de envio.
• Tela Audience no dashboard: painel único para administrar tópicos, segmentos e campanhas com ações de criar, editar, pré-visualizar, executar e excluir.

​

Templates com categoria de marketing e regras de descadastro

• Categoria do template: suporte para classificar templates como transacionais ou marketing.
• Vínculo com tópico de marketing: templates de marketing podem ser associados a um tópico específico para respeitar consentimento.
• Descadastro automático por canal:
  • SMS e WhatsApp: Reply STOP to unsubscribe.
  • E-mail: frase clicável click here to unsubscribe com link de preferências.
• Toggle por template: opção para habilitar/desabilitar o append automático do texto/link de preferências.

​

Benefícios práticos

​

Configurações de inbound por workspace (SMS e WhatsApp)

• inboundSettings.channels.sms.enabled
• inboundSettings.channels.whatsapp.enabled
• inboundSettings.channels.whatsapp.allowPrivateChats
• inboundSettings.channels.whatsapp.allowGroupChats
• inboundSettings.channels.email.enabled

• GET /v1/workspaces/:id retorna inboundSettings resolvido.
• PUT /v1/workspaces/:id aceita inboundSettingsPatch para merge parcial.

​

Atualização de preços e planos (resumo)

​

O que mudou nesta leva

• Mais créditos por faixa de plano: ampliamos os volumes de créditos mensais em diferentes tiers, mantendo a lógica de progressão para operações em crescimento.
• Ajuste de consumo por canal: recalibramos pesos de créditos em canais específicos para refletir melhor o custo real de envio.
• Redução de preço no avulso (SMS e RCS): o valor por envio no modelo Pague pelo uso foi reduzido.

​

Autenticação em dois fatores (2FA)

• TOTP: cadastre um app autenticador (por exemplo Google Authenticator ou equivalente) escaneando o QR code e confirmando com o código de 6 dígitos.
• Passkeys: registre chaves de segurança ou biometria do dispositivo para concluir o login sem digitar código quando o navegador suportar.
• Códigos de backup: ao ativar o TOTP, geramos códigos de uso único para acesso se você perder o celular; você pode regenerar os códigos quando precisar (a ação exige confirmar o segundo fator).

​

Limite de gasto por API Key

• Ilimitado: comportamento anterior: a chave só respeita créditos/saldo do workspace.
• Limite em créditos: a chave acumula o consumo em créditos de plano usados nas operações feitas com ela; ao ultrapassar o teto, novos envios retornam 402 Payment Required com código API_KEY_SPEND_LIMIT_EXCEEDED.
• Limite em centavos de real: a chave acumula o custo em centavos de saldo (Pague pelo uso / pré-pago); ao ultrapassar o teto, a resposta é a mesma (API_KEY_SPEND_LIMIT_EXCEEDED).

​

SMS: tamanho mínimo da mensagem

​

Painel e API (outras melhorias desta leva)

• Visão geral: ajustes na página de overview e na paleta dos gráficos para leitura mais clara dos números por canal.
• RCS: melhorias nas telas de criação e listagem de envios RCS no dashboard.
• SMS (recebidas e respostas): adicionamos o fluxo de SMS de entrada (MO) com eventos dedicados, listagem de recebidas no painel, detalhe da mensagem inbound e suporte a resposta automática opcional por envio.
• WhatsApp (enviadas e recebidas): a listagem passa a suportar abas separadas para mensagens enviadas e recebidas, com visualização dedicada das inbound no dashboard.
• Cobrança e envios: o fluxo de cobrança por envio e rotas de envio/cancelamento (WhatsApp, SMS, e-mail, push, RCS, templates) foram alinhados ao limite da API Key e ao registro de uso por chave, mantendo consistência entre canais.

​

Opção Pague pelo uso

​

Fila inteligente por workspace e otimizações de envio

​

Novo editor de templates para e-mail

​

Grupos do WhatsApp