AnyLinga
PT
Entrar Teste grátis

Central de ajuda/Agente de IA

Como enviar modelos, fotos ou vídeos ao cliente com um agente de IA

Atualizado: 2026-11-11

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/templates com o mesmo cabeçalho Authorization: Bearer <Token de callback>.
  • A resposta terá os campos id, name, category, provider, body e os anexos em attachments para cada modelo. Os modelos da WhatsApp Business API também terão o bloco meta.
  • Escolha os modelos necessários e copie seus valores de id para o envio.
O limite é de 30 requisições por minuto.

Inclua os modelos na resposta do agente

2. Adicione template_ids à resposta

  • Na resposta ao callback_url, inclua o array template_ids com até 5 IDs de modelos.
  • Adicione reply_text se 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.

Modelos de respostas rápidas · Modelos do WhatsApp · Como o agente pode iniciar uma conversa com o cliente

Este artigo foi útil?

Ficou com dúvidas?

Respondemos em horário comercial.

Já usa o AnyLinga?

Descreva sua dúvida e respondemos pelo WhatsApp ou por email.

Ainda não tem conta?

Teste você mesmo ou conectamos para você ao pagar o primeiro mês.

Conversar sobre a conexão

O que você precisa