what-syncs-and-what-does-not | O que sincroniza com a API, e o que não sincroniza

O que atravessa

Duas coisas, e elas são as duas que importam para um software que começa num número que uma empresa usa há anos.

• Contatos: todo contato com um número de WhatsApp pode ser sincronizado para a plataforma.
• Histórico de mensagens individuais, para que a API não fique cega em relação às conversas que aconteceram antes de ela existir.
• Dali em diante, as mensagens espelham nos dois sentidos: o que a API envia aparece no app, e o que a equipe digita no app chega aos seus sistemas.

O que não atravessa

Mais coisas do que as pessoas esperam, e essa é a lista que vale ler antes de prometer qualquer coisa a um cliente. Nada disso é limitação de provedor; é como a plataforma funciona.

• Conversas em grupo, que não sincronizam e não são alcançáveis pela API em provedor nenhum.
• Ferramentas de negócio: o catálogo, os pedidos e o status.
• Ferramentas de mensagem: mensagem de saudação, mensagem de ausência, respostas rápidas e etiquetas.
• Canais, chamadas de voz e vídeo, e os detalhes do perfil comercial.

Por que as ferramentas próprias do app ficam para trás

Porque elas são recursos do app, e não da plataforma, e a API não tem equivalente delas.

Respostas rápidas e etiquetas moram no aparelho. Uma mensagem de ausência é algo que o app envia quando ninguém está olhando para ele. Nada disso existe como conceito de API, então não há para onde essas coisas sincronizarem.

A consequência prática é que uma empresa que depende de etiquetas para organizar o trabalho continua usando elas no app, e o software não tem visibilidade nenhuma delas. Se essa organização importa para aquilo que você está construindo, ela precisa ser reconstruída do seu lado, em vez de ser lida de lá.

A janela que dá para perder

A sincronização precisa ser iniciada dentro de 24 horas do onboarding. Perca isso e o número precisa passar por offboarding e onboarding de novo para ter outra chance.

Isso é separado da janela de atendimento de 24 horas que governa o envio, e as duas são confundidas o tempo todo. Uma conta a partir da última mensagem do cliente e decide se o texto livre é entregue. Esta conta a partir do onboarding e decide se o histórico ainda pode ser puxado.

É também por isso que vale decidir sobre o histórico no dia em que um número conecta, e não quando o trabalho de integração começa, que costuma ser outra semana.

Erros comuns

• Prometer a um cliente que as etiquetas e as respostas rápidas dele vão aparecer no seu sistema. Elas ficam no app.
• Construir qualquer coisa em torno de conversas em grupo. Elas não sincronizam em provedor nenhum.
• Deixar a sincronização de histórico para quando a integração estiver pronta. A janela é de 24 horas a partir do onboarding.

Perguntas frequentes

Continue lendo