Central de ajuda

Central de ajuda

Respostas no nível da tarefa: o que configurar, em que ordem e quais falhas são silenciosas. Para o raciocínio por trás de como a plataforma se comporta, os guias vão um nível mais fundo.

Whaleal Cart

Instalar o app da Shopify, editar e-mails de recuperação, ajustar o timing de envio e corrigir uma recuperação que não disparou.

Help center do Whaleal Cart

Passo a passo de configuração, modelos, planos, solução de problemas e perguntas comuns — tudo em uma página.

Abrir o help center do Cart →

Primeiros passos

De uma conta vazia a uma mensagem que realmente saiu — e a um plano que cabe.

5 min

Primeiros passos

Conecte um provedor, gere uma chave, envie sua primeira mensagem — e conheça os dois padrões que, se passarem despercebidos, custam dinheiro em silêncio.

Ler este artigo →
4 min

Planos, cotas e faturamento

O que cada plano inclui, como se conta um «canal» e por que suas taxas de SMS nunca aparecem na nossa fatura.

Ler este artigo →

Canais e conexões

Você mantém sua própria conta de provedor. Veja o que isso significa na prática e como rotear entre várias.

5 min

Conecte sua própria conta de provedor

Trazer sua própria conta mantém contrato, reputação do remetente e fatura com seu provedor CPaaS. Veja como conectar uma e o que muda depois.

Ler este artigo →
3 min

Números de remetente e como são escolhidos

A maioria dos remetentes nunca especifica um endereço de origem, e isso costuma estar certo. Veja quando sobrescrevê-lo.

Ler este artigo →
5 min

Roteie entre provedores com prioridade e peso

Vincule uma chave a mais de um provedor e a plataforma vira a camada de roteamento — equilibrando carga quando tudo vai bem, fazendo failover quando não vai.

Ler este artigo →
4 min

Verifique uma conexão antes de depender dela

A verificação integrada só valida os campos que você digitou. Este é o teste que realmente prova que uma conexão funciona.

Ler este artigo →

API e entrega

Envio programático, chaves, status, recibos, limites de taxa e o log de mensagens.

3 min

Criar, vincular e rotacionar chaves de API

Uma chave prova qual tenant está chamando e quais canais ele pode usar. Ela é exibida por completo uma única vez, e uma chave sem vínculo não consegue enviar nada.

Ler este artigo →
6 min

Envie uma mensagem pela API

Um endpoint aceita de forma assíncrona. Um código de sucesso significa que a plataforma recebeu a mensagem — não que um aparelho a recebeu.

Ler este artigo →
4 min

O que significa cada status de mensagem

Quatro estados, e um deles não cabe no mesmo balde dos outros. Ler «bloqueado» como falha manda você procurar no lugar errado.

Ler este artigo →
5 min

Receber recibos de entrega

A plataforma faz um POST para uma URL que você configura, com um token que você gera. Dois detalhes de implementação decidem se você perde eventos.

Ler este artigo →
4 min

Limites de taxa e uso mensal

Há dois contadores, não são o mesmo número, e só um deles se parece com uma fatura.

Ler este artigo →
4 min

Encontre uma mensagem no log

O log responde «o que aconteceu com esta mensagem» sem guardar o conteúdo de ninguém.

Ler este artigo →
4 min

Rotacione uma chave de API sem interromper os envios

Substitua uma chave em quatro passos para que nunca falte quem possa enviar — e saiba o que fazer primeiro se a chave vazou.

Ler este artigo →

Envios em escala

Listas, lotes e envios agendados — com ritmo que protege os limites do seu provedor.

5 min

Envios em massa e agendados

Envie uma vez para uma lista, ou em uma data futura, com ritmo por lote que protege os limites do seu provedor.

Ler este artigo →
3 min

Contatos e listas

Mantenha em um só lugar as pessoas para quem você envia, importe-as em massa e agrupe-as sem duplicar ninguém.

Ler este artigo →
5 min

Estime quanto um envio vai custar

Segmentos × destinatários × tipo de remetente é a fórmula inteira. Veja como calculá-la antes de a fatura chegar.

Ler este artigo →

Opt-out e dados

O que acontece depois que um destinatário responde STOP, e o que a plataforma guarda sobre suas mensagens.

6 min

Opt-out e supressão

STOP, HELP e START são três ramificações diferentes. Configurar apenas o endpoint de recibos é o erro que faz toda a cadeia falhar em silêncio.

Ler este artigo →
3 min

O que guardamos e por quanto tempo

A plataforma guarda metadados sobre suas mensagens, não o conteúdo. Veja exatamente o que isso significa para seus próprios registros.

Ler este artigo →
4 min

Responder a um pedido de dados sobre um destinatário

O que a plataforma retém sobre uma mensagem, o que deliberadamente não retém e onde fica de fato a relação com o titular dos dados.

Ler este artigo →

Resolução de problemas

Diagnosticando os casos em que tudo retorna sucesso e a mensagem ainda não chega.

5 min

Mensagens aceitas, mas que não chegam

Toda chamada retorna sucesso. Siga esta ordem — as primeiras quatro verificações não envolvem a operadora.

Ler este artigo →
5 min

Mensagens que falham com código de erro

Um status de falha sempre traz um motivo. A primeira pergunta é qual camada o escreveu — a plataforma ou o provedor.

Ler este artigo →
3 min

Um destinatário recebeu a mesma mensagem duas vezes

Quase sempre é um timeout no cliente seguido de um reenvio. Veja como confirmar e como evitar que aconteça.

Ler este artigo →
5 min

Um provedor parou de aceitar tráfego

Separar uma falha no nível da conta de uma rota ruim, e o que o failover pode ou não absorver por você.

Ler este artigo →
Escopo. A maioria dos artigos aqui percorre o canal de SMS de ponta a ponta. O e-mail e o WhatsApp se conectam do mesmo jeito — você vincula sua própria conta de provedor e envia pelo console: 6 provedores no SMS, 4 no e-mail e 3 no WhatsApp. O envio agendado e em massa roda apenas no canal de SMS, e um provedor que ainda não listamos é registrado como uma solicitação pelo console em vez de ser oferecido como uma conexão.

Ainda com dúvidas

Se uma mensagem foi aceita e você não consegue dizer para onde foi, comece pelo artigo de solução de problemas — ele descarta camadas inteiras antes de você contatar a operadora.