lementos do Modelo
{receptor phone}: o número de telefone para o qual a mensagem será enviada. Este número deve incluir o prefixo internacional do país.
{API key}: a chave de API do trabalhador de IA. Esta chave define automaticamente o número de telefone a partir do qual a mensagem será enviada como o trabalhador, se o trabalhador estiver conectado a um canal do WhatsApp. Crie uma chave de API aqui.
{WPP API provider}: atualmente, todas as novas implementações devem usar “wa-cloud”, o que significa que o cliente está usando diretamente a API do WhatsApp através da META, e não por meio de um BSP (Business Solution Provider) como, por exemplo, Gupshup. Você ainda pode ver muitas implementações com “wa-gupshup”.
{pipeline ID}: é o ID do pipeline, que pode ser obtido na URL ao selecionar um pipeline na seção “Pipelines”.
Por exemplo, na URL:
https://app.getdarwin.ai/agent/1805/pipelines/2064
o número 2064 é o ID do pipeline, e 1805 é o ID do agente.
{template id}: o ID do modelo de mensagem. Uma mensagem enviada via API como mensagem de saída (outbound) deve ser baseada em um modelo, ou seja, o modelo precisa ser criado e aprovado pela Meta.
{param x value}: são os valores dos parâmetros do modelo, caso ele possua campos variáveis (por exemplo: nome, data ou hora).
O Objeto “Source” (Origem)
{datax} e {datax value}
O objeto “source” não é obrigatório. Ele só é necessário se quisermos que a mensagem carregue informações “ocultas”.
Chamamos de “ocultas” porque são informações não explicitadas no modelo.
O objetivo principal desse objeto, como o nome sugere, é descrever a origem da mensagem, portanto, o campo utm_source é obrigatório se o objeto source existir.
Além disso, nesse objeto também é possível enviar outros tipos de dados:
utm_medium: usado para descrever o meio de onde o lead veio (por exemplo: Facebook, Google, etc.).
utm_campaign: usado para descrever a campanha de onde o lead veio.
De qualquer forma, o produto já identifica automaticamente se um lead veio de um anúncio no Facebook ou Instagram.
Entretanto, nesse objeto source também podemos criar campos personalizados para enviar dados que podem ser úteis na conversa.
Por exemplo, podemos definir o seguinte:
"contact_id": 3523, "contact_interest": "Cars"
Podemos recuperar esses valores na máquina de estados usando os seguintes placeholders:
{session.source_parameters.contact_id} {session.source_parameters.contact_interest}O primeiro valor pode ser útil para uma requisição de API posterior na conversa, e o segundo pode ser útil para iniciar a conversa e direcioná-la para um caminho específico.