Tools do WhatsApp
As 10 operações do WhatsApp que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Listar contas comerciaisGETLista as contas comerciais do WhatsApp que o usuário do sistema alcança, com id e nome. Esse id é o waba_id das outras ferramentas, que a Meta agora também chama de Messaging account id. A resposta traz data e paging.cursors.after: passe-o como after para ler a próxima página.
- Obter conta comercialGETRetorna uma conta comercial do WhatsApp com os campos pedidos, que podem ser dados da conta ou análises. Sem fields, só id e name voltam.
- Listar números de telefoneGETLista os números de telefone comerciais de uma conta comercial do WhatsApp com id, display_phone_number, verified_name e quality_rating. Esse id é o phone_number_id das ferramentas de mensagem e perfil. A resposta traz data e paging.cursors.after: passe-o como after para ler a próxima página.
- Enviar mensagemPOSTEnvia uma mensagem de um número de telefone comercial e retorna seu id em messages[0].id. Os tipos livres (text, image, video, document, audio) só chegam a quem escreveu para o número nas últimas 24 horas; para iniciar uma conversa, envie o tipo template com um template aprovado de Listar templates de mensagem. A Meta cobra as mensagens da conta conforme seus preços do WhatsApp.
- Listar templates de mensagemGETLista os templates de mensagem de uma conta comercial do WhatsApp com id, name, language, status, category e components. A resposta traz data e paging.cursors.after: passe-o como after para ler a próxima página.
- Criar template de mensagemPOSTCria um template de mensagem e o envia para revisão da Meta, retornando id, status e category. Ele pode ser enviado quando o status for APPROVED, o que pode levar até 24 horas. As variáveis são {{1}}, {{2}} no formato POSITIONAL ou {{first_name}} no formato NAMED, e cada uma precisa de um exemplo. Um cabeçalho de imagem, vídeo ou documento precisa de um file handle de um upload, que esta conexão não faz.
- Atualizar template de mensagemPOSTEdita um template e o envia para revisão de novo. Só templates nos status APPROVED, REJECTED ou PAUSED podem ser editados, e apenas sua categoria e components; components substitui todas as partes. Um template aprovado aceita até 10 edições em 30 dias e 1 em 24 horas, e sua categoria não pode mudar.
- Excluir template de mensagemDELETEExclui um template pelo nome, em todos os idiomas, ou apenas a versão de idioma cujo id é hsm_id. O nome de um template aprovado excluído não pode ser reutilizado por 30 dias.
- Obter perfil comercialGETRetorna o perfil comercial que as pessoas veem em um número de telefone: about, address, description, email, websites, vertical e profile_picture_url.
- Atualizar perfil comercialPOSTAtualiza o perfil comercial de um número de telefone. Os campos omitidos mantêm seu valor, e websites substitui os sites do perfil.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
