O que sincroniza com a API e o que fica de fora

O que passa para a API

São duas coisas, precisamente as que mais importam para o software que começa a funcionar num número usado por uma empresa há anos.

• Contactos: todos os contactos com um número WhatsApp podem ser sincronizados com a plataforma.
• Histórico de mensagens individuais, para que a API não fique sem contexto sobre conversas anteriores à sua existência.
• A partir daí, as mensagens espelham-se nos dois sentidos: o que a API envia aparece na aplicação, e o que a equipa escreve na aplicação chega aos seus sistemas.

O que não passa para a API

É mais do que se espera, e vale a pena ler esta lista antes de prometer algo a um cliente. Nada disto é uma limitação do fornecedor; é assim que a plataforma funciona.

• Conversas de grupo, que não sincronizam e não ficam acessíveis através da API em nenhum fornecedor.
• Ferramentas empresariais: o catálogo, as encomendas e o estado.
• Ferramentas de mensagens: mensagem de saudação, mensagem de ausência, respostas rápidas e etiquetas.
• Canais, chamadas de voz e vídeo e detalhes do perfil empresarial.

Porque ficam de fora as ferramentas da aplicação

Porque são funcionalidades da aplicação, e não da plataforma, e a API não tem um equivalente.

As respostas rápidas e as etiquetas ficam no dispositivo. Uma mensagem de ausência é enviada pela aplicação quando ninguém a está a consultar. Nada disto existe como conceito da API, por isso não há nada que possa ser sincronizado.

Na prática, uma empresa que dependa de etiquetas para organizar o trabalho continua a usá-las na aplicação, mas o software não tem visibilidade sobre elas. Se essa organização for importante para o que está a criar, terá de ser reconstruída do seu lado, em vez de ser lida através da API.

A janela que pode perder

A sincronização tem de ser iniciada nas 24 horas seguintes à integração inicial. Se perder essa janela, o número tem de ser desligado e ligado novamente para ter outra oportunidade.

Isto é diferente da janela de atendimento ao cliente de 24 horas, que determina o envio, e as duas são confundidas constantemente. Uma conta a partir da última mensagem do cliente e decide se o texto livre é entregue. Esta conta a partir da integração inicial e decide se o histórico ainda pode ser transferido.

É também por isso que vale a pena decidir sobre o histórico no dia em que o número é ligado, e não quando começa o trabalho de integração, normalmente noutra semana.

Erros comuns

• Prometer a um cliente que as etiquetas e as respostas rápidas aparecerão no seu sistema. Ficam na aplicação.
• Criar qualquer funcionalidade à volta de conversas de grupo. Não sincronizam em nenhum fornecedor.
• Deixar a sincronização do histórico para depois de concluir a integração. A janela é de 24 horas após a integração inicial.

Perguntas frequentes

Continue a ler