Como enviar modelos, fotos ou vídeos ao cliente com um agente de IA
Para que seu agente de IA envie fotos, vídeos ou arquivos ao cliente, inclua o campo template_ids com os IDs dos modelos do AnyLinga na resposta ao callback_url. Você pode informar até 5 IDs; nesse caso, o campo reply_text é opcional.
Como os anexos são enviados
Um modelo é um conjunto de texto e anexos que você salvou previamente no AnyLinga. Seu agente escolhe os modelos necessários, e o AnyLinga os envia ao cliente.
Obtenha a lista de modelos
1. Consulte os modelos disponíveis
- Faça uma requisição
GET /api/connect/templatescom o mesmo cabeçalhoAuthorization: Bearer <Token de callback>. - A resposta terá os campos
id,name,category,provider,bodye os anexos emattachmentspara cada modelo. Os modelos da WhatsApp Business API também terão o blocometa. - Escolha os modelos necessários e copie seus valores de
idpara o envio.
Inclua os modelos na resposta do agente
2. Adicione template_ids à resposta
- Na resposta ao
callback_url, inclua o arraytemplate_idscom até 5 IDs de modelos. - Adicione
reply_textse precisar enviar um texto separado antes dos modelos. Se não precisar, você pode omitir esse campo.
{
"correlation_id": "b1e7d0c4-2f3a-4e8b-9c6d-7a5f1e2d3c4b",
"reply_text": "Aqui estão nosso catálogo e um vídeo sobre a entrega.",
"template_ids": ["7d1f0c2a-4b3e-4a9d-8c61-2e5f9b0a7d34"]
}
Na resposta, o AnyLinga retornará a lista templates com o resultado de cada modelo: ok, parts_sent ou o code do erro. Se não houver texto e nenhum modelo for enviado, a resposta será 502.
Você também pode incluir os modelos em /api/connect/send quando o agente inicia a conversa com o cliente.
Ordem de envio e restrições
Primeiro, é enviado o reply_text com a tradução. Depois, os modelos são enviados em sequência. O texto do modelo e os anexos são enviados em mensagens separadas. Vídeos são enviados como vídeos.
O texto do modelo não é traduzido: o cliente o recebe exatamente como está escrito no modelo.
Somente modelos publicados podem ser usados. Os modelos da WhatsApp Business API devem ser aprovados pela Meta. Caso contrário, o AnyLinga retornará 404 com o template_id desse modelo.
Os modelos são verificados antes de a resposta ser contabilizada. Se houver um erro no ID, corrija-o e envie a resposta novamente com o mesmo correlation_id.
Perguntas relacionadas
Modelos de respostas rápidas · Modelos do WhatsApp · Como o agente pode iniciar uma conversa com o cliente
Ficou com dúvidas?
Respondemos em horário comercial.